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WE KNOW YOU'RE ANXIOUS TO LEARN ALL ABOUT THE GRAPHIC SYSTEM, BUT. 



you'll miss valuable information if you don't start at the beginning! 
No matter what your objectives are, you should begin by reading the 
introduction in the Graphic System Operator's Manual. It presents an 
overview of the complete Graphic System documentation package, and 
it will help you select the study material you need to use the Graphic 
System effectively. 
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INTRODUCTION 



MATERIAL COVERED 

The major part of this manual discusses how to use the Graphic System to make graphs of 
data and functions. Some additional data, covering graph enhancements, drawn pictures and 
three-dimensional transformations, is also included. The material covered is appropriate for 
a person with no experience in graphic programming and only a brief introduction to BASIC. 

The programs shown are intended to be easily understood examples. Many of them can be 
made smaller, faster or otherwise better. Each example program is not presersted as the best 
way to perform a given task, only as a way which is easy to understand. 

Although this manual can be used as a quick reference guide, it is primarily written to be 
instructional. Each section assumes that all preceding sections have been reac. 
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GRAPH NOMENCLATURE 

Below is a typical graph which includes many features of a complete graph. The data curve 
itself, although very important, is among the simpler components. Second in importance 
are the axes and the tic marks which can be added. Major tic marks can be extended to be- 
come a grid system; minor tic marks can be added to improve clarity. 

The remaining additions all involve characters, either letters or numbers. 

The tic marks can be labeled. Labels on each axis indicate the meaning of the tic labels. The 
entire graph can be titled as shown. 



TITLE 





AXIS LABELS 



VII 
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EXAMPLE 

The following is an example to illustrate how Graphic System statements are used to make 
a simple graph. (The auto line number feature makes entering the program much easier.) 



lee tNiT 

118 MiNDOH >iae,iee,-iee,ie8 

12e AXIS 28,20 
138 HOME -88,-23 
148 FOR 1—88 TO 88 
1S8 DRAM I,8IN<I/5)»I 
168 NEXT I 
178 END 
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Section 1 



GRAPHIC STATEMENTS 



MOVE AND DRAW 

The fundamental building block of drawn information is the line, just as the fundamental 
building block of written information is the letter. To draw a line on a piec»! of paper, the 
pen is first moved to the line's starting point. The pen is placed on the paper and the line is 
drawn to the endpoint. Drawing a line on the Graphic System (GS) is the same process. The 
first step is to move to the line's starting point. The second step is to draw to the line's end- 
point. 




DRAW TO FINISH POINT 



MOVE TO STARTING POINT 



The Graphic System commands for these tasks are MOVE and DRAW. 



[ Line number J MOVE [ I/O address ] X coordinate in user data units , Y coiirdinate 



DRAW 



in user data units 



When drawing a line (sometime called a vector) on the GS, the starting and ending points of 
the line must be specified. A point on the display is located by specifying a horizontal posi- 
tion and a vertical position. As a result, each MOVE and DRAW command has two arguments: 
one for the horizontal position and one for the vertical position. By convention, the argu- 
ment specifying the horizontal position is the first of the pair, and the argument specifying 
the vertical position is the second. 
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GRAPHIC STATEMENTS 
MOVE AND DRAW 



T 



VERTICAL 
POSITION 



HORIZONTAL POSITION 



The arguments of the MOVE and DRAW commands can be any of the following: 



NUMERIC CONSTANT 



Examples: 1,5 

-.0089 

5025.45 

-1.34E207 



VARIABLE 



Examples: 



fi 

B3 

Z<£6> 



EXPRESSION 



Examples: fi+l 

-R+B«((COS<C)/U)»T) 



MOVE and DRAW alter the position of the GRAPHIC POINT. The position of the graphic 
point is analogous to the position of a pen on a plotter. When no program is running, the 
graphic point's position is shown by the blinking rectangular cursor. 
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WINDOW 



WINDOW 

The WINDOW command defines the limits of the data space that the Graphic System display 
IS "looking at". The person using the GS defines what these data limits are. For this reason 
the units in the MOVE, DRAW, and WINDOW commands are called USER DATA UNITS ' 
in this manual. Similarly, the limits defined in the WINDOW command form what is called 
a USER DATA SPACE. 

Before a graph is drawn on a sheet of paper, the paper must be marked off, both horizontally 
and vertically, into units appropriate for the information to be graphed. Foi instance, the 
same piece of graph paper can be used to show the progress of a glacier moving a few'centi- 
meters per year or a jet aircraft moving many kilometers per second. Before a graph is drawn 
on the display of the GS, the same marking process must be done. The WINDOW command 
accomplishes this. 



[Line number ] WINDOW minimum horizontal (X) value in user data units , maximum 

horizontal (X) value in user data units , minimum vertical Y) value in 
user data units , maximum vertical (Y) value in user data units 



The WINDOW command tells the GS what data values mark the boundaries of the display. 
For example, the graph program in the Introduction included the following statement: 




HINDOU >2e,2e.-i.i 



The WINDOW command tells the GS how to interpret the values specified in the MOVE and 
DRAW commands. After the above WINDOW command is executed, a MOVE -20,-1 
command will place the graphic point at the lower left corner of the display, a MOVE 20,1 
command will place the graphic point in the upper right corner of the display, and a MOVE 
0,0 command will place the graphic point in the exact middle of the display. Wl NDOW al- 
ways requires four arguments, just as MOVE and DRAW always require two arguments. 
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GRAPHIC STATEMENTS 
WINDOW 



As with MOVE and DRAW commands, the WINDOW arguments can be constants, variables, 
or expressions. There is no limit to the values these arguments can be, other than the numeric 
limits of the GS itself. 

For example, here is a valid WINDOW command: 




HIHOOU 1969, 1979i4. 816. S 



(This WINDOW command might be defining years on the horizontal axis and interest rates 
on the vertical axis.) 

After this command is executed, placing the graphic point at the lower left corner of the 
display requires a MOVE 1965,4.8. Here is another valid WINDOW command: 




MiNDOu -iE3ee,iE3ee. -IE-see, iE-3ee 
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GRAPHIC STATEMENTS 
WINDOW 



After this command is executed, placing the graphic point at the lower left corner of the 
display requires a MOVE -1E+300 -1E-300. The horizontal data minimum (the first 
argument of the WINDOW command) must always be less than the horizontal data maxi- 
mum (the second argument). The vertical data minimum (the third argument) must always 
be less than the vertical data maximum (the fourth argument). 

The WINDOW command also tells the GS how to interpret the arguments of MOVE and 
DRAW commands. How does the System interpret these arguments when n«) WINDOW 
command has been executed, such as when it is first turned on? To handle this situation, 
the GS establishes default window limits as shown below. 



100 



130 



Whenever it is turned on, the System in effect executes the following command: 

uiHDOu e,i3e,e,iee 

(The origin of these numbers is discussed later in this section.) These default window limits 
are also defined whenever any of the following commands are executed: 
INIT 

OLD 

DELETE ALL 

WINDOW limits which differ from these default values are usually desired. A WINDOW 
command defining the desired limits must be executed after any of the following events 
occur: 

— The GS is turned on 

— Any of these commands are executed: 

INIT 
OLD 
DELETE ALL 
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GRAPHIC STATEMENTS 
WINDOW 



The example program shown below will illustrate some of these concepts. After pressinc 
the PAGE key, enter the following statements into the GS: 



DELETE ALL 
100 PAGE 
lie INIT 
120 liOUE 0,0 
130 DRAU 130.100 
140 HOHE 
150 END 

RUN 
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GRAPHIC STATEMENTS 
WINDOW 



The GS will erase its display and then draw a line from the lower left corner to the upper 
right corner. The actual positioning of the graphic point during execution of this program 
can be observed by entering GOTO 100 into the System and then repeatedly pressing the 
"STEP PROGRAM" key. (This technique is useful for finding'errors in complex programs.) 

A series of example programs will now demonstrate how WINDOW affects the display. First 
press the PAGE key (this clears the display and places the cursor in the upper left corner, 
allowing space for the program to be entered). Now enter the following program: 

DELETE ALL 
INIT 

168 PAGE 
U8 nOUE 
128 DRAM 
138 DRAU 
148 DRAU 
158 DRAU 
168 HOHE 
EHD 



35,20 
35,88 
95,88 
95,28 
35,28 



This program draws a square box centered on the screen. 



178 
RUN 
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GRAPHIC STATEMENTS 
WINDOW 



Now enter the following: 



MINDQN >7e,2ad> -58,159 
RUN 



The result is a square box with each edge measuring half the length of the one previously on 
the screen. It is half size because the Wl NDOW statement defined the edges of the user data 
space to be twice as far apart as they were at the default values. The window defined by the 
above WINDOW statement extends from —70 to 200 user data units on the horizontal aixis 
and from —50 to +150 user data units on the vertical axis. So the screen is, in effect, looking 
at four times as much area. 
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GRAPHIC STATEMENTS 
WINDOW 



With the WINDOW statement, the display can be told to "look at" any recttingular area in 
user data space. Enter the commands shown below: 



RUN 



This produces a box the same height as the first box but very narrow. This occurs because 
the last WINDOW statement defined the data space the screen is "looking at" to be 1 100 
user data units wide, almost ten times wider than the width implied on the default value. 
Thus, the box looks very narrow even though its width in data units has not been changed. 
Note that the height is unchanged from the first time it was displayed because neither the 
box height in user data units nor the window height in user data units is different in this 
example. This demonstrates how to change the horizontal and vertical arguments in the 
WINDOW statement independently. They are totally independent. 




PLOT 50 GRAPHIC PROGRAMMING 



REV A, SEPT 1978 



1-9 
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VIEWPORT 



VIEWPORT 

When a graph is drawn on a piece of graph paper, it is not always appropriate for the graph 
to totally fill the paper on which it is drawn. There are times when space is needed around 
the edges for labeling or titling. In other situations more than one graph is to be drawn on a 
single piece of paper. These same situations can arise when drawing graphs on the Graphic 
System. The command used to handle them is VIEWPORT. 



Line number 


VIEWPORT minimum horizontal value in GDU's , maximum 




horizontal value in GDU's , minimum vertical value in GDU's , 




maximum vertical value in GDU's 



The VIEWPORT command is used to specify the size and location of an image on the GS 
display (and any other graphic device in the 4050 family). In the VIEWPORT command, the 
display of the GS is considered to be a rectangle 130 units wide by 100 units high. 



■100 



130 



These units are called GRAPHIC DISPLAY UNITS. Unlike user units, Graphic Display 
Units (GDU's) are fixed for a given device and never change. A horizontal GDU on the dis- 
play represents the same distance as a vertical GDU on the display. GDU's are used in the 
VI EWPORT command to specify the size and position of a graph or image on the display 
of the GS. As with MOVE, DRAW, and WINDOW, the arguments of VIEWPORT may be 
constants, variables, or expressions. However, the arguments of the VIEWPORT command 
are interpreted as being GDU's. All four arguments refer to the actual limits for graphic in- 
formation on the display. The GS will draw no lines outside these limits. The first argument 
is the location on the display of the left-most limit for graphic information. The GS will 
draw no lines to the left of this location. 
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GRAPHIC STATEMENTS 
VIEWPORT 



The second argument is the right-most limit. The third argument is the lowei limit. The 
fourth argument is the upper limit. To specify that an image occupy the whole display, a 
VIEWPORT command with the arguments shown below is executed: 

uiEUPORT e, 138,8, lee 

To specify that an image is to occupy only the lower left corner of the dispUiy, a VIEW- 
PORT command with the arguments shown below is executed: 

giEHPORT 8,65,8,58 




Just as there are default values for the WINDOW command, there are default values for the 
VIEWPORT command. The default size for an image is the full display. Whenever the GS is 
turned on, it in effect executes the following command: 

MIEUPORT 8,138,8,188 



This default viewport size is also defined whenever any of the following commands are 
executed: 

INIT 
OLD 
DELETE ALL 
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GRAPHIC STATEMENTS 
VIEWPORT 



For this reason, all examples so far in this section have referenced the whole display. They 
have been run as if a VIEWPORT 0,130,0,100 command had been previously executed. 
(The default WINDOW limits are 0,130,0,100. This defines a one-to-one correspondence 
between GDU's and user data units when the GS is first turned on.) 

If a viewport is desired which is different from the default size, a VI EWPORT command 
defining the desired size must be executed after any of the following events occur: 

— The GS is turned on 

— Any of these commands are executed: 

INIT 
OLD 
DELETE ALL 

For the next two examples, the square box program listed below should be in the GS 
memory. (Pressing the PAGE key and entering a LIST command will confirm if it is.) 

168 PAGE 

118 MOUE 35,28 

128 DRAM 35,80 

138 DRAU 95,88 

148 DRAM 95,28 

158 DRAM 35,28 

i€e HONE 

178 END 

After pressing the PAGE key, enter the following: 

INIT 
RUN 



The square box should now appear centered on the display. Now enter the following com- 
mands: 

UINDOU 8,138,8,188 
UIEHPORT 8,65,8,58 
RUN 



The square box reappears but with a different size and location. The graphic output of this 
program can be examined two ways. One way is to see what the viewport command has done 
(shown in the following diagram): 
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VIEWPORT 




VIEWPORT 8,65,8,58 



What formerly occupied the whole display now occupies only the lower left corner, as 
specified by the VIEWPORT 0,65,0,50 command, above. 

The left edge of the viewport is still the left edge of the display because the ^irst argument 
is zero (as in the default VIEWPORT 0,130,0,100). However, the right edge of the viewport 
is now only half way across the display because the second argument is 65 GDU's, half the 
display width of 130 GDU's. In specifying the vertical size of the viewport, h similar situation 
exists. The bottom of the viewport is still the bottom of the display but the top of the 
viewport is defined to be half way up the display (because the last argument in the above 
VI EWPORT command is 50 GDU's). 
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Another way to look at the output of this program is to see how the window has been af- 
fected. This is shown below: 



UINOOU 0,138,8,188 

The same window as in previous examples is now drawn with a different size and location 
on the display. It is otherwise unchanged. 

As with other GS commands, WINDOW and VIEWPORT are executed immediately if entered 
without a preceding statement number. An entered command becomes part of a stored pro- 
gram if it is entered with a preceding statement number. For example, 

UINDOU 8,138,8,188 
is executed immediately while 

258 UINDOU 8,138,8,188 
becomes statement 250 in whatever program is currently in GS memory. 
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WINDOW AND VIEWPORT 

WINDOW and VIEWPORT accomplish conceptually similar tasks. As shown in the diagram 
below, the combination of these two statements allow the selection of what is to be seen 
(WINDOW) and where on the display it is to be located (VIEWPORT). The WINDOW com- 
mand manipulates the size and location of the window on the user's data space. Its argu- 
ments are interpreted as user data units. The VI EWPORT command manipulates the actual 
size and location of the image on the display. Its arguments are interpreted as Graphic Dis- 
play Units. WINDOW can be used to "zoom" in on a particular area of a griaph to display 
more detail. VIEWPORT can be used to make several graphs appear on the display at one 
time. 

To repeat: VIEWPORT specifies the physical area on the display to be used for graphic in- 
formation; WINDOW specifies how many units of measure (that is, user data units) will be 
included within this physical graphing area. 



/ 



WINDOW DEFINED ON 
USER DATA SPACE (SIZE 
& POSITION DETERMINED 
BY WINDOW STATEMENT 
WITH ARGUMENTS IN 
USER DATA UNITS) 



DISPLAY VIEWPORT (SIZE & POSITION 
DETERMINED BY VIEWPORT STATE- 
MENT WITH ARGUMENTS IN GDU's) 
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Clipping 

These commands (WINDOW and VIEWPORT) also serve another function. As an example, 
try the following. Confirm that the square box program on page 1-7 is in the GS by entering 
the following statements: 

INIT 
RUN 

The square box should again appear on the center of the display. Now enter the following: 

INIT 

HINOOH 65,13e,58,iee 

RUN 



Notice now that because of the changed arguments in the WINDOW statement, only the 
upper right corner of the square appears (although it is filling the display). Because the 
VIEWPORT statement's arguments are at their default values (0,130,0,100), this upper right 
corner fills the display. 
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WINDOW is used to specify what is to be seen and what is not to be seen. Any lines which 
a program attennpts to draw outside the data limits specified in the WINDOW command are 
not drawn. Now enter the following: 

UIEUPORT 65,138,58,180 
RUN 



Preventing any drawing outside a specified WINDOW is called clipping. Only the upper right 
corner of the square appears, located in the upper right quarter of the display. The remainder 
of the square is not drawn because of the clipping capability of the GS. 
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SCALE 



[line number J SCALE horizontal scale factor , vertical scale factor 



As shown earlier, the WINDOW statement allows the user to define what portion of the data 
space is to be seen. The SCALE command is an alternative way to do this. In effect, SCALE 
allows the user to do the same thing that WINDOW does but in a slightly different way. After 
confirming that the box program on page 1-7 is in memory, enter the following: 

INIT 

88 HOUE 01 e 

98 SCALE 2,2 

RUN 
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SCALE 



The box appears half size in the lower left corner of the screen. Each argument in SCALE is 
interpreted to be the number of user data units which are to be represented by each GDU. 
The default values for these areguments are SCALE 1 ,1 . SCALE 2,2 indicates that the data 
should appear half the size it would have appeared with the default argument values. This 
also implies that, if the VIEWPORT arguments are unchanged, the same viewport on the dis- 
play should contain four times as much user data space area. 

Enter the following: 



INIT 

86 HOME 65,56 

96 SCALE 2,2 

RUN 
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The square box is drawn in the upper right quadrant of the screen. The only difference in 
these two examples is the MOVE command which preceded the SCALE command. These 
examples demonstrate another function of the SCALE command. SCALE sets the location 
of the point X = and Y = in user data space to be the current location of the graphic 
point. This sequence of statements: 

INIT 

NOME e,e 

SCALE 2,2 

is equivalent to: Wl NDOW 0,260,0,200. Similarly: 

INIT 

HOUE 65,58 

SCALE 2,2 



is equivalent to: WINDOW -130,130,-100,100. (The INIT commands in the two examples 
are not strictly required but are used to ensure that the first MOVE 0,0 is actually a move 
to the lower left corner of the display and that the second MOVE 65,50 is actually a move 
to the center of the display.) 

The INIT statement is used in this section to ensure that the examples have been run from a 
common starting point. INIT, in addition to other functions, restores the arguments of the 
WINDOW, SCALE, and VIEWPORT statements to their default values. These are: 

NINDOH d,13e,d,ld8 

SCALE 1,1 

UIEHPORT 8,139,8,108 

Because of the INIT command the arguments of the MOVE commands (which immediately 
preceded the SCALE commands in the examples) were all interpreted the same way. 
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GRAPHIC OUTPUT 

Earlier in tliis section, the MOVE and DRAW statements were discussed. Ttese statements 
and tlie other graphic output statements are now covered in somewhat more detail. All 
these statements affect the location of the cursor (also called the graphic point). The location 
of this point is always maintained internally by the GS and, if a program is not running, the 
GS constantly shows the physical location of this point on the screen. The graphic point is 
actually located in the lower left corner of the cursor's flashing rectangular dot matrix. This 
is the starting point for any graphic output operation. 



PAGE and HOME 

Two functions useful for cursor housekeeping tasks are PAGE and HOME. These commands 
can be executed either from the keyboard (using the PAGE and HOME key) or under pro- 
gram control (by entering a line number before the words PAGE and HOME). The box pro- 
gram on page 1-7 contains HOME used under program control. 

The PAGE command erases the display and moves the cursor to the "home" position. On 
the display, this is the position of the upper left most character the display m capable of 
printing. The HOME command, in contrast, only moves the cursor to the hdme position and 
does not erase the display. The HOME position is fixed. It is not affected by WINDOW, 
VIEWPORT, orSCALE. 



MOVE and DRAW 

Execute an INIT command and press the PAGE key. The cursor will appear in the display's 
upper left corner. A DRAW 0,0 will cause a line to be drawn from the current cursor loca- 
tion to the location X = and Y = in user data units, which, because of the INIT com- 
mand, is the lower left corner of the screen. The arguments of the DRAW command specify 
the end point of the line. The execution of a DRAW will cause a line to be drawn from 
wherever the graphic point is to the location specified in the DRAW commard. The resulting 
line is, of course, subject to the limits imposed by WINDOW. The cursor is moved from the 
HOME position in the upper left corner of the display to the position of the end point of the 
line. Press the PAGE key and enter DRAW 64.5,49.5. 

This will cause a line to be drawn to a location which is approximately in the middle of the 
display. The line ends at the cursor's lower left corner. The arguments of the DRAW com- 
mand (or any other graphic command) need not be integers. 
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RMOVE and RDRAW 

There are two types of MOVE and DRAW commands. The type that has been used so far in 
this section is called an "absolute" MOVE or DRAW command. These commands cause the 
cursor or graphic point to be moved from its present location (wherever that happens to be) 
to the location specified by the command's arguments (in user data units). 



r Line number ] RMOVE [" I/O address] X increment in user data units Y 
RDRAW ^ -■ - 



increment in user data units 



The other type of MOVE and DRAW command is called "relative". RMOVE and RDRAW 
are the relative move and draw commands. Either of these commands will cause the graphic 
point to be moved relative to its present location. That is, the arguments of the RMOVE and 
RDRAW commands are interpreted to be the distances (in user data units) to move away 
from the graphic point's present location. If the command RDRAW 64.5,49.5 is executed, 
a line is drawn from the current graphic point to a point 64.5 horizontal and 49.5 vertical 
user data units away from the beginning point of the line. 

Enter the following into the machine: 

DELETE ALL 

PAGE 

188 IHIT 

118 nOUE e,8 

128 RDRAH 64.5,49.5 

138 RDRAM €4.5,49.5 

148 HOME 

158 END 

RUN 
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Each of the RDRAW commands causes a line to be drawn from the current location of the 
graphic point to a point 64.5 horizontal and 49.5 vertical data units away. 

MOVE and DRAW cause the graphic point or cursor to be moved relative to the origin or 
0,0 point of the user data space. The arguments of these commands are treated as if they 
described an absolute location in user data space. RMOVE and RDRAW caua; the graphic 
point or cursor to be moved relative to its current location. The arguments of these commands 
are treated as incremental distances from the current point. Another example illustrates 
these differences. Enter the following into the Graphic System; 
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DELETE ALL 
PAGE 
lee INIT 
lie PAGE 
128 HOME 8,8 
138 DRAU 68,28 
148 HOME 8,58 
158 RDRAU 68,28 
168 DRAH 68,28 
178 HOHE 
188 END 

RUN 




Notice how the command which precedes each of the three DRAW commands affects 
execution. The first DRAW could have been a RDRAW without affecting the shape of the 
drawn pattern. This is because its beginning point is also the origin of the user data space 
coordinate system, that is, the point where X = and Y = 0. 
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ROTATE 



[ Line number ] ROTATE rotation angi 



e measured In the current trigonometric units 



A command which applies only to RMOVE and RDRAW is ROTATE. This command causes 
each RMOVE and RDRAW to be drawn rotated a specified angle from its ec<pected direction 
The point around which each RMOVE or RDRAW is rotated is its starting point. For 
example; enter the following commands: 

PAGE 

DELETE ALL 
INIT 

lae PAGE 
lie HOME 65,58 
128 RDRAU 28,8 
138 HOKE 
148 END 

RUN 
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The above program draws a horizontal line 20 data units long with its beginning point 
centered on the display. Now enter the following: 

SET DEGREES 
ROTATE 45 
RUN 




The same RDRAW command is executed, but the resulting line is rotated 45 degrees counter- 
clockwise around its beginning point. The significant feature about this, other than the ro- 
tation, is that the line is rotated around its beginning point. This also happens to be the 
ending point of an absolute MOVE, which was not rotated. The following example demon- 
strates the usefulness of this characteristic: 
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DELETE ALL 

180 INIT 

118 SET DEGREES 

128 PAGE 

139 ROTATE 9 

148 nOUE 65,58 

158 REM DRAM A TRIANGLE 

1£8 RDRAW 48,10 

178 RDRAU -48,18 

188 RDRAU 8,-28 

198 HOnE 

298 END 

RUN 
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The display should now show a narrow isosceles triangle "pointed" to the right. Add the 
following statements: 

132 GOSUB 148 
134 ROTATE 99 
136 GOSUB 146 
138 END 
298 RETURN 

RUN 




The triangle has been drawn again but rotated 90 degrees counterclockwise around the 
vertex that corresponds to the endpoint of the MOVE command. This point of rotation can 
be placed anywhere desired. For example, enter the following statement into the GS: 

155 RHOUE -19,-18 
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Below is a listing of the program as it now looks: 

lee iNiT 

118 SET DEGREES 

126 PAGE 

138 ROTATE 8 

132 GOSUB 148 

134 ROTATE 98 

136 GOSUB 148 

138 END 

148 HOME 65,50 

158 REM DRAU A TRIANGLE 

155 RHOUE -10,-18 

168 RDRAU 48,18 

178 RDRAM -48,18 

188 RDRAU 0,-28 

198 HOME 

286 RETURN 
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If the program is run again by entering RUN, the result (shown in the preceding diagram) 
is a triangle oriented like the first one in the previous example, "pointed to the right", and 
another triangle. This triangle is also oriented at right angles to the first one but the axis of 
rotation is now centered inside both triangles. This effective rotation point is still the end 
point of an absolute MOVE command. The reason why the rotation axis changed was that 
the inserted RMOVE command at line 155 shifted the triangle in relation to the end point 
of the last absolute MOVE. This rotation axis can also be determined by the end point of 
an absolute DRAW. 

It should be emphasized again that the ROTATE statement affects only relative moves 
and draws, that is, only the RDRAW and RMOVE commands. Some uses of the ROTATE 
command are discussed later in this manual. 



Graphing Arrays 

The MOVE, RMOVE, DRAW, and RDRAW commands all have a similar array output cap- 
ability which greatly simplifies outputting a series of connected lines or other large amounts 
of graphic information. If forty lines are to be drawn on the screen, two one-dimensional 
arrays of length 40 are dimensioned as follows: DIM X(40),Y(40). Each successive X and Y 
value is placed in the corresponding array element by using a FOR . . . NEXT loop or any 
other appropriate process. In other words, the horizontal location (in user data units) of 
the first point is placed into X(1), the vertical location of the first point is placed into Y(1) 
and so forth until the arrays are filled. To draw these lines, all that is necessary is the command 
DRAW X,Y. This command will cause a line to be drawn from the current cursor location 
to the X(1),Y(1). From there it draws a line to X(2),Y{2). This continues until both arrays 
are exhausted. The arguments of the DRAW command can be either scales or arrays. The 
command will automatically handle either situation. Of course, both arguments must be 
scalars or both must be arrays. The types cannot be mixed. 

If the variables X and Y are arrays, DRAW X,Y is the equivalent to: 



318 FOR 1=1 TO 40 
320 DRAM X<I>,Y(I> 
330 NEXT I 



This implied output sequence is applicable to DRAW, RDRAW, MOVE, and RMOVE. Here 
is an example: 
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PAGE 

DELETE ALL 

188 PAGE 

118 INIT 

128 DIM X(48),Y<48) 

138 REM FULL ARRAYS WITH DATA 

148 FOR I«l TO 48 

198 K(I>«U3.25 

168 Y<I>«SQR(ABS<I-28>>»2e 

178 HEXT I 

188 REM MOUE TO THE FIRST POINT 

198 MOUE X(1),Y<1) 

288 REN DRAU BOTH ARRAYS 

218 DRAU X,t 

228 HOME 

238 END 

RUN 
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Both arrays used must have the same number of elements. If they do not, an error condition 
results. Note also that this alternating output of array elements is different from that of the 
PRINT statement. If the statement PRINT X,Y is executed with the arrays X and Y dimen- 
sioned as above, the sequence of output is as follows: X(1),X{2),X(3), . . . X(39),X{40), 
Y(1 ),Y(2),Y(3), . . .Y(39),Y(40). All elements of the X array are output before the first 
element of the Y array is output. 



WINDOW and VIEWPORT Examples 

As a review, here are seven examples which illustrate capabilities of WINDOW and VIEW- 
PORT. All seven examples use the same figure for output: a circle of radius 75 centered at 
X = Oand Y = 0. They demonstrate how WINDOW and VIEWPORT determine what is shown 
on the display. Each example program performs three functions: 

1. Fill arrays X and Y with data necessary to draw the circle 

2. Define a window and viewport 

3. Draw the circle. 

In all seven examples, the statements which perform the first and third functions (above) 
are identical. The only difference among the programs is in function 2 — the window and 
viewport definition. 

Please enter the following statements (this is the first of the seven examples): 

PAGE 

DELETE ALL 

lee REM FILL ARRAYS WITH DATA 

118 REM REPRESENTING A CIRCLE 

lae INIT 

138 DIM XC72),Y<72) 

148 SET DEGREES 

158 FOR 1=1 TO 72 

168 X<I>=75*C0S<I«5) 

178 Y<I)=75*SIN<I*5) 

180 NEXT I 

190 REM 

200 PAGE 

210 REM DEFINE WINDOW AND VIEWPORT 

220 WINDOW 0,130,0,100 

230 UIEWPORT 0,130,0,100 

240 REM DRAW THE CIRCLE 

250 GOSUB 500 

260 HOME 

270 END 

580 REM SUBROUTINE TO DRAW CIRCLE 

510 MOUE X<72>,Y<72) 

520 DRAW X,Y 

530 RETURN 

RUN 
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In all seven examples, statements 100 through 190 are identical. These statements fill arrays 
X and Y with the appropriate data. Statements 500 through 530 are also identical in all 
seven examples. These statements form a subroutine to draw the data in arrays X and Y. 
The MOVE command at statement 510 positions the graphic point to the correct starting 
point for the circle to be drawn. This program's output is shown below: 




As a result of these window limits, only the upper right quarter of the circle is shown on 
the display. 
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In the example below, the window is changed so that the whole circle is visible. Enter 
the following statements: 

228 UINOOU -138, 13e> -168,108 
RUN 288 

This produces the output shown below: 




In the preceding example, the program was executed with the following command: RUN 
200. (This causes the program execution to start at statement 200.) Once data arrays X and 
Y have been filled with data, as they were in the first example of this series, they need not 
be filled again. Since filling the arrays with data is the function of statements 100 through 
190, these statements are skipped. 
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There is an implied horizontal and vertical scaling whenever a window is defined. The im- 
plied horizontal scaling and implied vertical scaling can be varied independently. The next 
two examples show that data which represents a circle will be drawn with a different shape 
if the window is defined inappropriately. Enter the following statements: 

228 UINDOM -136,138,-508,506 
RUN 288 




In the program output above, the width of the drawn figure is the same as in the example 
which immediately preceded it. The WINDOW command arguments which specify the hori- 
zontal data range are identical in both examples. However, the WINDOW command argu- 
ments which specify the vertical data range are different. This causes the different shaped 
figures. 
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The next example changes the horizontal range. Enter the following: 



22e UINDOU -588,568,-108,166 
RUN 266 



■ 



To draw a figure with no distortion, the ratio of the viewport's height and width must be the 
same as the ratio of the window's height and width. This is discussed in more detail in 
Section 8. 
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In the next example the window is restored to its previous dimensions (-130,130,-100,100) 
but the viewport is changed so that it no longer coincides with the full size of the display. 
Enter the following: 

228 UINDOH -1301130,-188,180 
238 MIEUPORT 65,138.8,50 
RUN 200 




As the program output shows, the viewport is now defined to be the lower right corner of 
the display. This was specified in the VIEWPORT command in statement 23(1 There has 
been an implied change of scale because the same window must fit into a smaller portion 
of the display. 
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The next example shows how different windows can be defined for the same display area. 
Enter the following statements: 

PAGE 

228 uiNDou e,i3e,e,iee 

238 MIEHPORT 9, 129,6, IM 

248 COSUB 588 

258 UtNDOU -138,138,-188,188 

268 GOSUB 588 

278 HOHE 

288 END 

RUN288 




The command GOSUB 500 appears twice. As a result, the circle is drawn twice. There are 
two WINDOW commands. Each causes a different portion of the circle to be visible when 
the routine at statement 500 is called. However, only one viewport is defined (in statement 
230). This means that both windows occupy the same area on the display. 
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In the previous example, statements 220 through 260 determine what is placed on the dis- 
play. Here is a summary of their functions: 

220 WINDOW 0,130,0,100 Specifies a window which covers the uppur right section 

of the circle. 

230 VIEWPORT 0,130,0,100 Specifies a viewport which fills the dispiiy. 

240 GOSUB 500 Draws the circle subject to the defined window and view- 

port. Because of the WINDOW command at statement 
220, only the upper right section of the circle appears on 
the display. 

250 WINDOW -130,130,-100,100 Specifies a window which covers the whole circle. 

260 GOSUB 500 Draws the circle subject to the defined window and view- 

port. Because of the WINDOW command at statement 
250, the complete circle appears on the display. 

The next example draws everything seen on the display in the above exampli; but, through 
a change in viewport parameters, draws the image in the upper right quarter of the display. 
It also adds some additional data in the lower left quarter of the display. Enter the following 
statements: 

PAGE 

238 UIEHPORT 65,136,50,188 

278 UINDOU -138,8,8,188 

288 UIEUPORT 8,65,8,58 

298 GOSUB 588 

388 HOME 

318 END 

RUN288 

The entire program now looks like this: 

188 REH FILL ARRAYS HITH DATA 

118 REM REPRESENTING A CIRCLE 

128 INIT 

138 DIM X<72),Y<72> 

148 SET DEGREES 

158 FOR I»l TO 72 

168 XCI>«75*C0S<1»5) 

178 Y<I)«75*SIN<I*5) 

188 NEXT I 

198 REM 

288 PAGE 

218 REM DEFINE WINDOW AND VIEWPORT 

228 WINDOW 8,136,8,189 

238 UIEWPORT 65,138,58,186 

248 GOSUB 588 

258 WINDOW -138,138,-106,188 

268 GOSUB 586 

278 WINDOW -138,8,8,188 

288 UIEUPORT 8,65,8,56 

298 GOSUB 588 

368 HOME 

318 END 

586 REH SUBROUTINE TO DRAW CIRCLE 

519 HOME X<72),Y<72> 

528 DRAW X,Y 

538 RETURN 
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The output from this program looks like this: 




The above example demonstrates that any portion of the user data space can be shown at 
any place on the display. Statements 220 through 290 determine what is visible on the dis- 
play. Here is a summary of their functions: 



220 WINDOW 0,130,0,100 
230 VIEWPORT 65,130,50,100 
240 GOSUB 500 



250 WINDOW -130,130,-100,100 
260 GOSUB 500 



Specifies a window which covers the upper right section 
of the circle. 

Specifies a viewport to be the upper right quarter of the 
display. 

Draws the circle subject to the defined viewport and 
window. Because of the WINDOW command at statement 
220, only the upper right section of the circle appears; on 
the display. 

Specifies a window which covers the whole circle. 

Draws the circle subject to the defined window and view- 
port. The complete circle appears because of the WINDOW 
command at statement 250. 
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270 WINDOW -130,0,0,100 
280 VIEWPORT 0,65,0,50 
290GOSUB 500 



Specifies a window which covers the upper left section of 
the circle. 

Specifies a viewport to be the lower left quarter of the 
display. 

Draws the circle subject to the defined window and view- 
port. Because of the WINDOW commarsi at statement 
270, only the upper left section of the 6 fc\e appears. 



WINDOW and VIEWPORT Summary 

All seven examples illustrate the same two principles: 

— The window and viewport are defined independently. Different windows can be de- 
fined for one viewport; different viewports can be filled with the same- window. 

— The currently defined window and viewport together determine what appears on the 
display. 

WINDOW defines what data is seen. VIEWPORT defines where on the display it appears. 



AXIS Command 



[ Line number] AXIS [ I/O address 1 



X axis tic interval in user data units , 

Y axis tic interval in user data units , X axis intercept in user data units , 

Y axis intercept in user data units 



The AXIS command draws horizontal and vertical axis lines, with tic marks if desired. The 
command can be used with four arguments, with two arguments or with no arguments. De- 
fault values are supplied in place of any missing arguments. The AXIS command with no 
arguments draws a horizontal and a vertical line through the origin of the user data space 
(X = and Y = in user data units) if this point is inside the defined window. If this point 
is not inside the window, the axis lines are drawn through the minimum X end Y data values. 
In other words, unless X = is within the window, the vertical or Y axis is drawn at the left 
edge of the window; and unless Y = is within the window the horizontal or X axis is drawn 
at the bottom edge of the window. 
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The following examples illustrate the default location of the axes. Enter the following: 

DELETE ALL 
PAGE 
188 PAGE 
118 INIT 
128 AXIS 
138 END 

RUN 



Since INIT is equivalent to WINDOW 0,130,0,100, the point X = and Y = is at the lower 
left corner of the display. So the vertical axis is at the left edge of the display and the hori- 
zontal axis is at the bottom edge. After the AXIS is drawn, the graphic point is placed at the 
intersection of the two axes. In the above example, the two axes intersect at the lower left 
corner of the display. When execution is complete, that is the cursor's location. 

Press the PAGE key and enter the following statements: 

115 HINDOH -5e,5e,-S8i58 

125 HOHE 

RUN 
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The axis lines cross at the center of the display because that is the location of the origin 
(X = and Y = 0) of the user data space. (The HOME command at statement 125 is added 
to make updating this program easier.) 



Enter the following: 



115 UINDOU -lee, -58,-108,-56 
RUN 
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The axis lines cross at the lower left corner of the screen, because that is where the mini 
n^um values of X and Y occur. Notice that the AXIS statement defines minimum value to 
be minimum algebraic value, not minimum absolute value. 

Enter the following: 

lis uiNDOu -5e,5e»5e,iee 

RUN 



1-44 



REV A, SEPT 1 978 



PLOT 50 GRAPHIC PROGRAMMING 



GRAPHIC STATEMENTS 
GRAPHIC OUTPUT 



The vertical axis is now centered on the display because the point X = is located halfway 
between the left and right edges of the display. The horizontal axis, as before, passes through 
the Y data minimum and, as a result, is located at the lower edge of the display. 

The first two arguments of AXIS (whether it is being used with four arguments or only two) 
specify the interval in user data units between tic marks. The first argument is the interval 
between tics on the horizontal or X axis; the second argument is the interval between tics 
on the vertical or Y axis. If an interval of zero units is specified in either argument, no tics 
at all are drawn on the axis corresponding to that argument. 

Enter the following: 

115 UtNDOH -25,25i-25,25 

128 AXIS 8,ie 

RUN 



Because the arguments in the WINDOW statement have placed the point X = and Y = in 
the middle of the screen, the axes are drawn with their crossing point centered on the screen. 
Notice there are no tic marks on the horizontal axis (because the first argument of the AXIS 
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Statement is zero). However, because the second argument of AXIS is 10, there are tic marks 
on the vertical axis spaced 10 user data units apart. The tic marks are always aligned with 
the crossing point of the axes, as they are here. The length of the tic marks is always 1% 
of the viewport size in the corresponding direction. For example, if the AXIS statement is 
executed after a VIEWPORT 0,50,0,100 statement, the tic marks on the vertical axis are 
.5 GDU in length (1% of the 50 GDU width of the defined viewport) and the tic marks on 
the vertical axis are 1 GDU in length (1% of the 100 GDU height of the defined viewport). 



The third and fourth arguments of the AXIS statement allow the user to specify the hori- 
zontal and vertical intercepts of the axes. The third argument is the location in horizontal 
or X data units of the vertical axis intercept. Similarly, the fourth argument is the location 
in vertical or Y data units of the horizontal axis intercept. 

Enter the following: 

12e UINDOM e, 268, e, 280 
RUN 



1-46 



REV A, SEPT 1978 



PLOT 50 GRAPHIC PROGRAMMING 



GRAPHIC STATEMENTS 
GRAPHIC OUTPUT 



The AXIS statement causes the vertical axis to be drawn through X = 10, a point near the 
left edge of the display, and causes the horizontal axis to be drawn through Y = 100, a point 
in the middle of the display. 



Axis can be used to easily draw a box around the specified window. The exjimple below 
illustrates how this is done. Press the PAGE key and enter the following statements: 

DELETE ALL 

168 PAGE 

lid INIT 

128 DATA -48,55,-22,89 

138 READ M1,U2,U3,W4 

148 UINDOM U1,U2,U3,U4 

158 AXIS 8,8,U1,U3 

1€8 AXIS 8,8,U2,U4 

178 HOME 

188 END 

RUH 



The AXIS command at statement 150 draws lines at the left and bottom edqes of the window. 
For this particular task, two AXIS commands perform the function of one MOVE and four 
DRAW commands. 
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CHARACTER OUTPUT 

This part of the manual discusses output of characters (letters and numbers) to a graphic 
device. This is done with the PRINT statement. A fundamental concept of outputting in- 
formation to a graphic device is that the cursor's location defines the starting point for both 
character output and graphic output (lines). If a DRAW statement is executed, the starting 
point of the resulting line is the lower left corner of the cursor's current position. If a 
PRINT statement is executed, the first character is normally output at the cursor's current 
position and the cursor is moved to the position of the next character (to the right of the 
cursor's starting position). 

Positioning with IMOVE 

Character output can be placed anywhere on the display by preceding the PRI NT with a 
MOVE. For example; press the PAGE and enter the following statements: 

DELETE ALL 

186 PAGE 

118 INIT 

120 PRINT "HESSAGE"} 

136 HOME 

148 END 

RUN 



MESSAGE 
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The message is placed at the upper left corner of the display because that \% the cursor's 
position after the PAGE statement is executed. Enter the statements below: 

115 HOUE e,3 
RUN 



MESSAGE 



The message is placed in the lower left corner of the screen because of the MOVE 0,0 state- 
ment. Enter the following statements: 

115 HOME 65,56 
RUN 
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In this case the message is placed in the middle of the screen because of the MOVE 65,50 
which places the cursor in the center of the screen. Enter the following statements: 



DELETE ALL 

lee PAGE 

118 UINDOM 9,136(0,100 

12d MIEUPORT 65,130,50,100 

130 HOUE 130,100 

140 DRAU -130,-100 

150 HOME -130,-100 

160 PRINT "MESSAGE"? 

170 HOME 

180 END 

RUN 
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Notice that, although the line resulting from the DRAW statement is clipped at the bound- 
aries set up by VIEWPORT, the MOVE and PRINT statements are not clipped. After the 
WINDOW and VIEWPORT statements are executed, the center of the display is equivalent 
to X = and Y = in user data units. It is also the lower left corner of the viewport. The 
DRAW statement attempts to draw a line beyond this point but is prevented from doing 
so. However, the MOVE statement can place the cursor at any point on the display and the 
PRINT statement can place characters at any point on the display. 
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Character Size 



Characters placed on an 1 1 -inch display with a PR INT command have only one size and 
orientation. The size of the characters has four components: the height of the five by 
eight rectangular dot matrix which is used to form the character, the width of that matrix, 
the horizontal distance between adjacent characters in a line of characters, and the vertical 
distance between adjacent lines of characters. Refer to the figure below. These distances 
on an 1 1-inch display are all constant and are expressed in GDU's as follows: 



CHARACTER 
WIDTH 



"1 



CHARACTER 
HEIGHT 



CHARACTER 

SPACE 

HEIGHT 



CHARACTER 

SPACE 

WIDTH 



Height of character 1.88 GDU's 

Width of character 1.55 GDU's 

Character space width 1.79 GDU's 

Character space height 2.82 GDU's 



Positioning with PRINT 

As described previously, the cursor can be moved to any point on the display by using the 
MOVE statement. There are also four characters which move the cursor on the display hori- 
zontally in increments of the distance between adjacent characters and vertically in incre- 
ments of the distance between adjacent lines. Using these characters, the cursor can be 
moved in any direction and thus can also be moved to any point on the display. 
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Action 


Character 


Obtainable 


How to Place 


ASCII 


Moves 


Name 


From Key- 


Into a Charac- 


Value 


Cursor 




board With 


ter String 




To the right 


SPACE 


SPACE BAR 


A$ = " " 


3:' 


To the left 


BACKSPACE 


CTRLH 


A$ = "H" 


f: 


Down 


LINE FEED 


CTRL J 


A$ = "J" 


ID 


Up 


VERTICAL TAB 


CTRL K 


A$ = "K." 


n 



Three of these characters are entered as control characters: Control H, Contiol J, and Con- 
trol K. 

To enter a control character into the Graphic System, the CTRL key is used much like the 
SHIFT key. A control character is entered by pressing the desired character xey while simul- 
taneously pressing and holding the CTRL key. The "space" character (entered with the 
SPACE BAR) moves the cursor to the right by 1.79 GDU's, the distance which separates 
adjacent characters. The "backspace" character (which prints on the screen m "H" or 
"Control H") moves the cursor to the left by the same distance. The "linefw-d" character 
(which prints on the screen as "J" meaning "Control J") moves the cursor down by 2.82 
GDU's, the vertical distance which separates adjacent lines of characters. Thi? "vertical tab" 
character (which prints on the screen as "K" or "Control K") moves the cursor up by the 
same distance. These distances are all GDU's and are not affected by the WINDOW, VIEW- 
PORT, or SCALE statements. When manipulating the cursor in this way, it must be remem- 
bered that the cursor is moved to the right whenever a non-control character is output. For 
an example of this method of cursor manipulation, press the PAGE and enter the following: 

DELETE ALL 

198 INIT 

118 PAGE 

128 NOUE £5)58 

138 PRINT *A BtJJJCUbUDUiiJi'') 

RUN 
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The resulting output looks like this: 
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When the program has finished execution, the cursor is placed in the same position as the 
first character output (the A). 

As mentioned earlier, a fundamental point about outputting information ta a graphic de- 
vice is that the cursor's location defines the starting point for both charactei output and 
graphic output. For example, here is a program which draws two connected lines from the 
upper left corner of the display to the lower right corner of the display. Press PAGE key 
and enter the following statements: 

DELETE ALL 
lee PAGE 
lie INIT 

126 HOUE 8,iee 

138 DRAM 65,50 
148 DRAU 138,8 
158 HOHE 
168 END 

RUN 
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If a PRINT statement is added between the two drawn lines, the end point of the first line 
and the beginning point of the second line no longer coincide. Enter the following statements: 

135 PRINT "ABCDEF"} 
RUN 




The beginning point of the second line is displaced by the characters printed by the PRINT 
command at statement 135. The DRAW command at statement 140 specifies only the end 
point to which the line will be drawn. It draws the line from wherever the graphic point is 
located when statement 140 is executed. 

This example illustrates that care must be taken when lines and printed characters are out- 
put in the same program. 
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One way to avoid inadvertent distortion of graphic output is to keep track of the number of 

characters being output at a given PRINT statement. Then, by using the control characters 

described above, backspace and up-space to the beginning location of any diaracter output. 

Subsequent graphic output may be continued as if nothing had been output at that point. 

The next example illustrates a way to do this. Press the PAGE key and enta- the following 

statements: 

DELETE ALL 

Ide PAGE 

lie INIT 

120 A«-»ABCDEF'* 

139 HOME a,iee 

He DRAM 65,50 

158 PRINT Mi 

160 FOR 1*1 TO LEN(A*) 

170 PRINT "a"J 

180 NEXT I 

190 DRAW 130,0 

200 HOHE 

210 END 

RUN 

Here is the resulting output: 




PLOT 50 GRAPHIC PROGRAMMING 



REV A, SEPT 1978 



1-57 



GRAPHIC STATEMENTS 
CHARACTER OUTPUT 



Control H is a backspace character. The FOR . . . NEXT loop at statements 150 to 170 
simply backspaces the number of characters output in A$. The DRAW at line 180 is then 
continued appropriately. 

Statements 160 through 180 use only the number of characters in A$ to determine the 
graphic point's movement. This is appropriate when the PRINT command is placed in a ;;ub- 
routine. No positional information is then required by the subroutine. In the example pro- 
gram (above) statements 160 through 180 could easily be replaced by the following com- 
mand: MOVE 65,50. This approach is simpler in the context of the example. However, it 
might not be appropriate when used in a different program. The example here simply shows 
an alternative way to perform the same function which requires different information. One 
way requires the number of characters in the character string which is printed. The other 
way requires the position on the display where it was printed. Both approaches are valid. 
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GRAPHIC INPUT 
GIN 



[ Line nymber ] GIN [ I/O address ] target variable for X coordinate 
target variable for Y coordinate 



Several commands in the Graphic System language are useful for finding oltl where the 
graphic point is located. The GIN or graphic input command is the principal means of per- 
forming this task. For example, press the PAGE key and enter the following statements: 

DELETE ALL 

186 PAGE 

118 INIT 

128 UINDOM 8,888,8)888 

138 HOME 8,8 

148 DRAU 288,188 

158 GIN A,e 

168 HOHE 

178 PRINT A,B 

188 END 

RUN 



288.873846154 



99.328 



PLOT 50 GRAPHIC PROGRAMMING 



REV A, SEPT 1978 



1-59 



GRAPHIC STATEMENTS 
GRAPHIC INPUT 



In the above example, the endpoint of the line shows the position of the graphic point when 
the GIN command is executed. The location of the graphic point in user data space deter- 
mines what values are placed in the GIN command's target variables. 

In a program such as the example above, it is unlikely that the values returned by the GIN 
command will exactly match the values in the DRAW command (statement 140). The ac- 
curacy of GIN is determined by the resolution of the graphic device being addressed, not 
on the GS. Each type of graphic device has a different resolution. For instance, the re- 
solution of a CRT display, such as the one on the GS, is different from the resolution of a 
plotter. If a full size viewport is defined for the display, the values returned from GIN will 
have less than .125% error. This represents a worst -case accuracy (for a full size viewport) 
of better than 1 part in 800. In the above example, the window is defined to be 800 by 800 
user units. An accuracy of better than 1 part in 800 means that the values returned by the 
GIN command will never differ more than 1 data unit from the values in the DRAW command. 

The values returned by GIN are user data units. Running the above example with a different 
window illustrates the significance of this fact. Enter the following: 

128 uiNDOu e,3ee,e,38e 

RUN 
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Because of the totally different window, the actual displayed location of the line's endpoint 
has changed. However, the values returned from GIN are virtually identical. The arguments 
of the DRAW command are unchanged. Therefore, the location of the line's endpoint in user 
data space is the same. 

As in the previous example, the maximum error (in user data units) will be no greater than 
1/800 of the defined window size. 

300*(1/800) = .375 user data units. 

Below is an example which uses GIN. This program moves the position of the graphic point 
with the user definable keys. The position of the graphic point is always indinated by the 
flashing dot matrix which is normally seen on the display. Enter the following: 

DELETE ALL 
1 GO TO 138 

4 RHOUE 8,1 

5 RETURN 

8 RHOVE -1,8 

9 RETURN 

12 RHOUE 1,8 

13 RETURN 

24 RMOME 8,-1 

25 RETURN 

36 GIN X,Y 

37 RETURN 
48 GIN A,B 

41 MOVE X,Y 

42 ORAM A«B 

43 X=A 

44 Y»B 

45 RETURN 
188 INIT 
118 PAGE 
128 X'9 
138 Y«8 

148 HOUE 8,8 
158 END 

RUH 
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Here is a summary of the key functions and a diagram of each function's relative position: 

Key 1 Moves the graphic point up one data unit. 

Key 2 IVIoves the graphic point to the left one data unit. 

Key 3 Moves the graphic point to the right one data unit. 

Key 6 Moves the graphic point down one data unit. 

Key 9 Saves the current location of the graphic point as the beginning point of 

a line. 
Key 10 Draws a line from the last specified beginning point to the current location 

of the graphic point. 



f^ UP 4^left4^right^|JIIII]^|^)I \ 



]/~-DO\NN-\\) \[y- lj|/-MOVE J^j-DRAW-I^ 



10 
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SUMMARY 

The fundamental building block of drawn information is the line. Any line it defined by a 
beginning point and an end point. To draw lines on the Graphic System, the DRAW com- 
mand is used. The arguments of the DRAW command determine the end point of a line. 
The starting point for output on the GS display is the graphic point. DRAW causes a line to 
be drawn from the current location of the graphic point to the location spedfied in the 
DRAW command's arguments. The MOVE command simply moves the position of the 
graphic point to the location specified by the MOVE command's arguments. 



The Wl NDOW command specifies the minimum and maximum limits of displayed data 
values. These are called user data units. The arguments of MOVE and DRAW are interpreted 
to be expressed in these units. 




T — y / / 

HINDOM -189,108, -160, lee 
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The VIEWPORT command specifies the actual size and location of the rectangle on the dis- 
play which contains data limits defined by WINDOW. The arguments of VIEWPORT are ex- 
pressed in GRAPHIC DISPLAY UNITS. These units of measure are constant. GDU's are 
used to specify an actual physical location on the display. 




UIEHPORT 39,90,39,70 



WINDOW specifies what data is to be seen. VIEWPORT specifies where on the display il: 
is located. 
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Both the WINDOW and VIEWPORT are set to default sizes whenever any of the following 
events occur: 

— the GS is turned on 

— any of these commands are executed: 

INIT 
OLD 
DELETE ALL 



WINDOW explicitly defines the data limits. WINDOW and VIEWPORT to»;ther imply scale 
factors. The SCALE command (with arguments expressed in user data unite per GDU) ex- 
plicitly defines horizontal and vertical scale factors. SCALE and VIEWPORT together im- 
plicitly define the data limits. 

MOVE and DRAW specify a location in user data space which is "absolute' , independent 
of the starting point. RMOVE and RDRAW specify a location relative to the present loca- 
tion of the graphic point. 

ROTATE applies only to RMOVE and RDRAW. A positive argument produces counter- 
clockwise rotation, a negative argument produces clockwise rotation. 

If the arguments of a DRAW command are arrays, all the data points in the arrays are con- 
nected with lines. For example, if X and Y are arrays, the command DRAW X,Y draws a 
line to the point X{1 ),Y(1), then the point X(2),Y(2), and so forth. RDRAW, MOVE, and 
RMOVE also have this capability. 

The AXIS command produces axis lines with tic marks if desired. If the intoirsection of the 
axis lines is not specified, a default location is computed. 

The PRINT command is used to place character information on the display The characters 
can be located using the MOVE command or any of several control characters. Since the 
graphic point determines the starting point for both lines and characters, care must be ex- 
ercised when lines and characters are mixed in the same image. 

The current location of the graphic point in user data space can be found w th the GIN 
command. It returns values in user data units. 
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ARRAYS 

Any data to be graphed must first be input into the Graphic System. This section discusses 
input techniques appropriate for various types and sources of data. While eech example pro- 
gram in this section can be run as listed, each one represents only the data input sub-section 
of a larger, more complete program. 

In this section of the manual, the term "data value" denotes a single number while the term 
"data point" denotes a pair of data values used to specify a location in user data space. 

Beginning at this point in the manual, the following assumption is made about all example 
programs: the GS memory has been cleared of any other program and data before the ex- 
ample is entered. Clearing memory is the function of the DELETE ALL conmand. It was 
used prior to each example in Section 1. There are a few instances where tho example state- 
ments are to be added to a program already in memory. Each of these instances is specifically 
mentioned. 

Data to be graphed may be stored in a group of simple (non-subscripted) variables. For 
example, the first value plotted can be stored in Scalar variable A, the second value in B and 
so forth. As can be quickly seen, editing, plotting and otherwise manipulating data stored in 
this fashion is very cumbersome. A better technique is the use of arrays. With data stored in 
arrays, it is easier to have the machine do more of the required work. Either one or two 
dimensional arrays can be appropriate for a given situation. Ways to use one dimensional 
arrays are discussed in most of this section. Changes necessary for the use o1 two dimensional 
arrays are discussed at the end of this section. 

Before any data can be placed in an array, the array's size must be initialized so that it con- 
tains at least as many elements as the minimum number of data values expe»;ted. The DIM 
command is used for this purpose. Any program which uses the data in this array needs to 
know how many data values it contains. (This number may be less than the size of the 
array.) The user must set up some convention so that this may be accomplished easily. 

The most versatile way to communicate how many data points the array ccMitains is to de- 
dicate one simple (non-subscripted) variable to contain the number of data values in the 
particular array. If any deletions or additions are made to the data array, thi;n the number 
contained in the dedicated variable must also be decremented or incremented appropriately. 
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Another way of accounting for the number of data values in an array is to have the dedicated 
location (containing the number of data values in the array) be the first element in the array. 
This has several disadvantages. The index of a particular data value (in relation to the other 
data values) is not the same as its location in the array. For example, the sixth data value in 
a given array of data values is the seventh element in the array. Another major disadvantage 
has to do with retrieving the array after it has been placed onto an external storage device, 
such as tape. This will be discussed in more detail in the part of this section which deals with 
tape. 



Another method is to write the program so that it will recognize some number, such as 
-999.999, as a non-valid data value. This number is then placed in every array element 
which does not contain a valid value. Along with the storage-related disadvantage of the 
previous method, this method does not allow rapid determination of the number of data 
values a given array contains. 



All three of these methods require the same amount of storage: one more variable than the 
number of data values actually being stored. So the criteria of versatility and ease of use 
should determine which method is preferable. As described above, having a separate variable 
containing the number of data values is the best method for most applications. 
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FROM THE KEYBOARD 

To enter data into the GS from the keyboard, the INPUT command is used. There are four 
fundamental methods for using the INPUT command to bring data into an array. 

One way to place data from the keyboard into an array is with a FOR . . . NEXT loop, as in 
the following example: 

298 PAGE 

300 PRINT "SIZE OF ARRAY = "; 

310 INPUT N 

320 DELETE A 

330 DIM A<N> 

340 FOR I»l TO N 

350 INPUT A(I> 

360 NEXT I 

370 REH END OF INPUT 

380 END 



First, the desired size of the array is placed into the variable N (statement 310). Statement 
320 deletes the array. This is done to be sure that no other arrays are in merliory with the 
same designation and that this array is dimensioned properly. Next, the size of array A is 
specified (statement 330). Then, a FOR . . . NEXT loop is used to cause the INPUT state- 
ment to be executed the appropriate number of times, with each data value inputted being 
placed into the correct array element. 

There is a simpler way to perform the same task, taking advantage of the implied FOR . . . 
NEXT loop in the input statement. When the statement INPUT A is executftJ with variable 
A being an array, the GS automatically executes the INPUT statement enough times to fill 
the array. In effect, it sets up the FOR . . . NEXT loop of statements 340 to 350 in the pre- 
vious example. So the last example can be replaced with the one below: 

290 PAGE 

300 PRINT "SIZE OF ARRAV = "; 

310 INPUT N 

320 DELETE A 

330 DIM A(N> 

340 INPUT A 

350 REM END OF INPUT 

360 END 
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The input statement at line 340 will always start filling array A at its first element and con- 
tinue until the array is filled. If either of these actions is inappropriate then a FOR . . . 
NEXT loop, such as the one shown in the previous example, must be set up. Using the 
intrinsic array capability of the INPUT command allows a series of input values to be 
separated by keys other than the carriage return. Some of them are the comman, the 
asterisk (*), the slash (/), or the up arrow (t). 

The other two methods of keyboard input (described below) involve setting up a continuous 
input loop which is then terminated in various ways. These methods share a common advant- 
age (the exact number of elements in the array does not need to be specified in advance) 
and two common disadvantages: the array must be dimensioned to a size which is estimated 
to be greater than the largest number of data values expected to be input; and a check is re- 
quired to ensure that the array size is not exceeded. 

It is possible to set up a loop to input data points into an array so that a particular data 
value, specified in advance, terminates the loop. For example: 



n • 
f 



290 


PAGE 






3ee 


PRINT "SIZE 


OF ARRAY 


s 


318 


INPUT N 






320 


DELETE A 






33e 

340 


DIM A<N) 
As0 






350 


C=0 






360 


INPUT Kl 






370 


IF Kl«-999.999 THEN 


410 


380 


C=C+1 






390 


ACO-Kl 






400 


IF C<H THEN 


360 




410 


REM END OF INPUT 




420 


END 







Again, the count of valid data values, C, is only incremented after the input of a valid 
number has been completed. When this method is used, one data value must be specified 
as the flag. This particular value cannot be a valid data value. 
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A way to minimize this disadvantage is to specify what the flag value is to hv. before the be- 
ginning of the input loop. For example: 



296 PAGE 

309 PRINT "SIZE OF ARRAY « "5 

318 INPUT N 

313 PRINT "UALUE OF TERMINATING FLAG 

317 INPUT T 

328 DELETE A 

338 DIH A(N) 

348 As8 

358 Cb9 

368 INPUT Kl 

378 IF K1»T THEN 418 

388 C«C-M 

398 A<C)sKl 

488 IF C<N THEN 368 

418 REH END OF INPUT 

428 END 



In this case, each data value input is compared with T, rather than a constant, to determine 
if the final data value has been entered. 

Another method is to use the character string capabilities of the GS. If a stri ig of letters is 
used to terminate the input loop, there is no requirement for any numeric viilue to serve as 
a flag. This method uses the string function VAL (which converts a character string composed 
of the characters 0.1 ,9,E-i-,-) to a number. 

For example: 



290 PAGE 

389 PRINT "SIZE OF ARRAY » "; 

310 INPUT N 

320 DELETE A 

338 DIM A(N),K»<28) 

348 A«0 

350 C=0 

368 INPUT K« 

378 IF K*«"DONE" THEN 418 

380 C«C+1 

398 ACC)=VAL<K«) 

400 IF C<N THEN 360 

410 REH END OF INPUT 

420 END 
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Using the program example above, data values can be entered into successive elements of 
array A until the character string DONE is entered. This will cause the GS to exit from the 
loop and begin executing the statements following the loop. Memory space will be conserved 
if the string variable K$ is dimensioned to the length of the longest anticipated terminating 
character string. The default size for K$ is 72 characters, an unneeded length in this con 
text. A statement such as 330 DIM A(N),K$(20) would be appropriate for this example, 
since most of numeric data values require fewer than 20 characters to express. 

It is also possible for the terminating character string to be specified just prior to the input 
loop. For example: 

298 PAGE 

388 PRINT "SIZE OF ARRAY « "; 

318 INPUT N 

328 PRINT "TERMINATING STRING » "I 

330 DIM T«<2e) 

349 INPUT T* 

350 DELETE A 

360 DIM A<N>,K*(20> 
370 A-0 

380 c-e 

390 INPUT K» 

400 IF K*-T* THEN 440 

410 C«C+1 

420 a<c)«ual<:k»> 

430 IF C<N THEN 390 
440 REM END OF INPUT 
450 END 



Both T$ and K$ have been dimensioned to conserve memory space. If not dimensioned, 
each would have space for 72 characters. When a character string identical to the one entered 
into T$ is input, the test in statement 400 is true and the loop is exited via statement 430. 

There is one terminating string which is very convenient to use: the null string. This is the 

character string which contains nothing. In the previous example, T$ contains the null string 

if the user enters only a carriage return in response to the "TERMINATING STRING = " 

request. Another way to specifying the null string as the terminating string is shown in the 

following example. 

298 PAGE 

380 PRINT "SIZE OF ARRAY - "; 

319 INPUT N 

320 PRINT "TERMINATING STRING = "J 
330 DIM T*<20> 

340 INPUT T* 

350 DELETE A 

360 DIM A<N>,K*<20> 

370 A=0 

380 C=0 

390 INPUT K* 

400 IF Kf»T« THEN 440 

410 C=C+1 

420 A<C)=yAL(K$) 

430 IF C<N THEN 390 

440 REM END OF INPUT 

450 END 
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To terminate this loop, merely follow the carriage return which enters the last data value 
with an extra carriage return. The extra carriage return inputs a null string, which is recog- 

ni7firl anri raii<;p<: thp Innn +n ho ovitoH 



nized and causes the loop to be exited 



Another technique for terminating an input loop is to set up a user definable key as the 
terminating event. For example: 

1 GO TO 290 

4 GO TO 390 

290 PAGE 

300 PRINT "SIZE OF ARRAY = "! 

310 INPUT N 

320 DELETE A 

330 Din A<N> 

340 (\=& 

350 SET KEY 

360 FOR I-l TO N 

370 INPUT A<I) 

380 NEXT I 

390 REM END OF INPUT 

480 END 



In the previous example, pressing the user definable key 1 causes an immed ate branch to 
statement 390. When statement 390 is executed, I will be one greater than ihe number of 
data values input. 

A similar example: 

1 GO TO 290 

4 GO TO 380 

290 PAGE 

300 PRINT "SIZE OF ARRAY = "5 

310 INPUT N 

320 DELETE A 

330 DIM A(N) 

340 A«-999.999 

350 SET KEY 

360 INPUT A 

370 REM END OF INPUT 

380 FOR 1=1 TO N 

390 IF A<I>=-999.999 THEN 419 

400 NEXT I 

410 C=I-1 

420 REM C IS NUMBER OF UAL ID DATA UALUES 

430 END 
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This example uses the array capability of the GS to do much of the required work. State- 
ments 380 through 410 are required because, with this approach, there is no intrinsic way to 
determine how many values have been input into the array. (In the previous example, the 
value of I after leaving the FOR . . . NEXT loop provided that information.) Statement 340 
is needed to initialize all the array elements to a specified dummy value. Any element con- 
taining this value has not had a valid data value placed into it. Statements 380 through 410 
determine how many valid data values have been entered. 

Prior to graphing the input data, the minimum and maximum must be known. There are two 
times this can be done: as the data is entered, and just prior to graphing. If variable R1 is; 
the minimum and R2 is the maximum, the following is an example of how the minimum 
and maximum might be determined at entry time: 



t 



298 PAGE 

390 PRINT "SIZE OF ARRAY 

318 INPUT N 

320 DELETE A 

330 DIN A<N),Kf(2e) 

349 ({sQ 

343 Rl«l.OE-»-3e0 
347 R2—1.9E+300 

359 C=9 

360 INPUT Kl 

370 IF K**"" THEN 418 

380 C=C+l 

398 A(;C>«MAL<K«) 

393 R1»R1 NIN A<C) 

397 R2»R2 MAX A<C) 

400 IF C<H THEN 360 

410 REN END OF INPUT 

420 END 



The min-max determination adds only four statements (343, 347, 393, 397). The two initi- 
alization statements (343 and 347) set the minimum to an artifically large positive number 
and the maximum to an artificially large negative number. This ensures that any given data 
entry will be detected as a minimum or a maximum. (If statements 343,347,393 and 397 
are removed, the above example is identical to the one on page 2-6 which uses the null 
string to terminate the input loop.) 

The other time to determine the minimum and maximum is just prior to graphing. This 
technique has the advantage of including any changes to the data which occurred after it 
was entered. In the following example, C is the number of data items in array A and R1 
and R2 are the minimum and maximum respectively. 
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298 PAGE 

398 PRINT "SIZE OF ARRAY » "} 

318 INPUT N 

328 DELETE A 

338 DIH A<N),KI<28) 

348 A«8 

358 C>8 

368 INPUT K$ 

378 IF Kf""" THEN 418 

388 C*C*1 

398 A<C)«UAL<KI) 

488 IF C<N THEN 368 

418 REM END OF INPUT, FIND MIN t< MAX 

428 Rl«1.8E+388 

438 R2=-1.8E+388 

448 FOR I«l TO C 

458 R1*R1 HIN A(I> 

468 R2*R2 MAX A(I> 

478 NEXT I 

488 END 



This technique of scanning after entry is useful when data is entered from sources other than 
the keyboard, as examples later in this section demonstrate. 

Use of the minimum and maximum values is discussed in Section 3 of this manual. 
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EDITING AN ARRAY 

Editing a data array already in the GS memory is sometimes necessary. Data editing is made up 
of five processes: 

— Listing current data 

— Replacing a data value with a new one 

— Deleting a data value 

— Appending a data value to the end of the current array 

— Inserting a data value into the current array. 

Referring to any data item within an array can only be done two ways: by referring to the 
item's position or index within the array (e.g., A{4)), or by referring to the value of the data 
item (e.g., the first data item equal to 3). Because a data item's index is so often used for 
reference, and because the five editing processes each have a different effect on the contents 
of a data array, care must be exercised during an editing operation. 

The five editing processes are now discussed in the order mentioned, with examples. The 
array used. A, can contain no more than N data values. In the following five examples, N is 
20. C is the working size of the array. It represents the number of valid data values currently 
contained in array A. In each of the following examples, 10 is the beginning value of C. (Each 
of the first ten elements of A is filled with a value which is ten times the element's index. 
(Statements 160 through 180 in each program perform this function). 



Listing Data 

When listing an array, it is very useful to print each item beside that item's index. This 
simplifies further reference to each data point. Here is a way this can be done: 



188 PAGE 

118 INIT 

128 N>2e 

138 C«18 

148 DIH A<N) 

158 A*8 

168 FOR 1*1 TO C 

178 A<I>«ie«I 

188 NEXT I 

198 REH LIST UALUES IN ARRf^Y A 

288 IF C>8 THEN 239 

218 PRINT "NO DATA UALUES IN ARRAY A" 

228 GO TO 268 

238 FOR 1=1 TO C 

248 PRINT I,A(I> 

258 NEXT I 

268 END 
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These statements cause each data item to be printed on the display just to the right of that 
data item's index. There is a check to ensure that the program will not attempt to print an 
empty array (statement 200). If C is zero, there are no valid data values in the array. An 
array with no data values should not be listed. 

In the next four example programs the index number of an array element is required before 
the specific editing function can be performed. If the null string is entered when the pro- 
gram requests the element index (by pressing only the carriage return key ar; that point), 
program execution is terminated in each case. 



Changing Data 

If a given data value is to be changed, the following statements can be used; they allow 
changes to be made very easily. 

188 PAGE 

lie IHIT 

128 H«2d 

138 C«18 

148 DIM A<N.) 

158 A»e 

168 FOR I«l TO C 

178 A<I.>=18*I 

188 NEXT I 

198 REH CHANGE DATA UALUE 

288 PRINT "INDEX OF ITEM TO CHANGED = "5 

218 INPUT I* 

228 IF I$«"" THEN 318 

238 IsUAL<I«) 

248 IF I=>1 AND I<=C THEN 278 

258 PRINT "INDEX IS OUT OF RANGE" 

268 GO TO 318 

278 PRINT "CURRENT UALUE OF A<";l5") IS "5A(I) 

288 PRINT "CHANGE THIS TO "; 

298 INPUT A<I.^ 

388 GO TO 198 

318 END 



Included is a check for a proper item number (statement 240). The current tem's value is 
printed prior to the change being made. In this example, the input to the process is treated 
as a string which is tested to see if it is the terminating string. If it is, the process is exited 
(in the example, control branches to statement 310). If it is not the terminating string, then 
the change process is continued. 

Neither of the previous two examples resulted in any change of the number of data items in 
the array. All three following processes will result in a change in the number of data items 
in the array. 
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Appending Data 

If a given data point is to be appended to an array, the following statements will accompi ish 
the task: 



lee PAGE 
lie iNiT 

128 N>2e 

139 c*ie 

140 DIM A<N> 
158 A>e 

168 FOR I-l TO C 

178 A<I>-18»I 

188 NEXT I 

198 REH APPEND DATA UALUE 

288 IF C<N THEN 238 

218 PRINT "ARRAY IS FILLED" 

228 GO TO 298 

238 PRINT "UALUE OF ITEM TO BE APPENDED 

248 INPUT U* 

258 IF U$«"" THEN 298 

oga C=C+1 

278 A(C)=UAL<U$) 

288 GO TO 288 

298 END 



The number of data points in the array (C) is changed only after valid input has been entered. 
The array A has been dimensioned to contain N data elements. A check has been included 
so that the array's size will not be exceeded and thus cause an error (check is statement 200). 
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Deleting Data 

If a given data point is to be deleted from an array, the following statements can be used: 



109 PAGE 
lie INIT 
128 H<20 

138 c»ie 

148 DIM A<N) 

158 A>e 

168 FOR 1=1 TO C 

178 A(n = 10*I 

188 NEXT I 

190 REM DELETE DATA VALUE 

288 IF Oe THEN 238 

218 PRINT "ARRAY IS EMPTY" 

228 GO TO 370 

238 PRINT "INDEX OF ITEM TO BE DELETED 

258 IF !$=-» THEN 379 

268 I=UAL(I*) 

278 IF I=>1 AND I<=C THEN 308 

288 PRINT "INDEX IS OUT OF RANGE" 

298 GO TO 288 

388 PRINT "UALUE DELETED = "; 

318 PRINT A<1) 

328 FOR J«I+1 TO C 

338 A<J-1)=A<J) 

348 NEXT J 

358 C«C-1 

366 GO TO 288 

378 END 



The program must "ripple" through the array, moving all data items after th » deleted one 
toward the beginning of the array by one position. 
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Inserting Data 

The last kind of editing mentioned is the insert process, allowing a data value to be inserted 
at any point in the array. This process must also "ripple" through the array, but it moves 
all the data items toward the end of the array by one position. 

lee PAGE 

118 INIT 

128 N>2e 

130 C»18 

148 DIH A<N> 

158 A»8 

168 FOR 1«1 TO C 

178 A<I)«ie«I 

188 NEXT I 

198 REM INSERT DATA UALUE 

288 IF C<N THEN 238 

218 PRINT "ARRAY IS FILLED" 

228 GO TO 370 

238 PRINT "INDEX OF ITEM TO BE PRECEDED = "\ 

240 INPUT I* 

258 IF 1*="" THEN 370 

268 I-UAL(I$> 

278 IF I«>1 AND I<»C THEN 388 

280 PRINT "INDEX IS OUT OF RANGE" 

298 GO TO 288 

300 FOR J«C TO I STEP -1 

318 A(J+1>«A(J> 

328 NEXT J 

338 CaC+1 

348 PRINT "UALUE TO BE INSERTED = "; 

3Se INPUT A<I> 

360 GO TO 198 

370 END 



The working size of the array (C) must be incremented to make room for the insertion 
(statement 330). Statement 270 is a check to ensure that the item preceded is within the 
working size of the array. Statement 200 is a check to ensure that the array is large enough 
to contain the insertion. 
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FROM A FUNCTION 

Graphing a single-valued function is fundamentally similar to graphing an array of data 
values. However, there are some differences in the way the data is supplied 1o the graphing 
program. 

The most satisfactory way to set up the graphing of a function is to place the function to 
be graphed within a FOR . . . NEXT loop. This can be done directly, as in the first program 
example in Introduction. It can also be done indirectly, by placing within the FOR. . .NEXT 
loop a GOSUB reference to the function. For example: 



lee FOR X«B TO E STEP I 

iia GOSUB 68de 

128 DRAM X,Y 

138 NEXT X 



6880 REM SAMPLE FUNCTION 
6818 Y=SIH(X> 
6828 RETURN 



Any function to be graphed need only be keyed into the GS starting at line fiOOO and followed 
by a RETURN statement. 

Notice that the FOR . . . NEXT loop requires certain information about the function's in- 
dependent variable (called X in this example). Three values must be specified: the beginning 
value (called B in this example), the ending value (called E in this example), and the in- 
crement (called I in this example). This data allows the GS to successively evaluate the func- 
tion within a specified domain at specified intervals. 

A minor change is necessary if graphing a specified number of points within the domain of 
the function is desired. The FOR . . . NEXT loop lends itself to using a specified increment. 
In order to graph a specified number of points, divide the total domain (the maximum 
minus the minimum) by the number of points desired. The quotient will be the increment. 
With this approach, statement 100 of the previous example would look like the following: 

100 FOR X = B TO E STEP (E-B)/N 

In this case, N is the desired number of points to be graphed. 
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In order to graph the function, two additional data are required: the minimum and maxi- 
mum of the function within the specified domain. Unless these values are estimated, they 
must be determined by evaluating the function throughout its domain just as if it is being 
graphed. An example of how this is done follows (this example cannot be run as listed): 



ISe REM FIND MINIMUM AND MAXIMUM 

118 REM MINIMUM IS Ml, MAXIMUM IS M2 

128 Ml-1.8E43ee 

138 M2=-1.8E+300 

148 FOR X»B TO E STEP I 

158 GOSUB 6088 

168 M1«M1 MIN Y 

178 M2=M2 MAX Y 

180 NEXT X 

198 NINDOU B,E,M1,M2 



6888 REM SAMPLE FUNCTION 
6818 Y=SIN(X) 
6828 RETURN 



The minimum and maximum resulting from this calculation can be used directly in a 
WINDOW statement. This ensures that the viewport is filled with the appropriate part of the 
user data space. 

Parametric functions are handled in much the same way as simple functions. (This manual 
calls Y = SIN(X) a simple function and 

Y = SIN(T) . , . . 

= rOS(T) ^ parametric function.) 

To graph a parametric function, or to find its minimum and maximum, the only change 
needed in the above examples is in the variables in the FOR and NEXT statements (this 
example cannot be run as listed) : 
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188 FOR T=B TO E STEP I 

118 GOSUB 6888 

128 DRAW X,Y 

138 NEXT T 



6886 REM SAMPLE PARAMETRIC FUNCTION 
6818 Y=SIN(T> 
6828 X=COS<T) 
6838 RETURN 



It is possible to have the same program graph both simple and parametric functions. A 
convention must be made as to which variables are dependent and independent in simple 
and parametric functions. The chart shows the convention used in the following example: 



Simple Function 



Independent 
Variable 



X 



Parametric Function 



Dependent 
Variable 



X& Y 



188 FOR T»B TO E STEP I 

lie X«T 

128 GOSUB 6888 

138 DRAM X,Y 

148 NEXT T 



188 FOR T«B TO E STEP I 

lie X«T 

128 GOSUB 6888 

138 DRAU X,Y 

148 NEXT T 



6888 REM SIMPLE FUNCTION 
6818 Y=SIN(X) 
6828 RETURN 



6888 REM PARAMETRIC FUNCTION 
6818 X=COS(T> 
6828 Y=SIN(T> 
6838 RETURN 



The function at line 6000 will be evaluated properly regardless of whether it is simple or 
parametric. 
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FROM TAPE 

Any discussion of graphing data stored on tape must be prefaced with a discussion of appro- 
priate ways to store data onto tape. The GS internal tape drive is a sequential access device. 
This means that in order to read a data item at the end of a tape file, the whole file must be 
read in first. Reading a data item that precedes one which was just read is a two step pro- 
cess. First, the tape must be positioned back to the beginning of the file. Then, in order to 
find the desired item, the file must be re-read up to the desired item's location. (The tape 
can only be positioned within a file by reading data.) This means that the kind of data 
manipulation done by a program should influence the way it stores and reads data on the 
tape. Here is one method of storing data on the tape which is suitable for data to be graphed. 
The first value to be stored in a tape file is the number of graphed points which will fill 
the remainder of the file. Each graphed point might typically require 1, 2, or 3 numeric 
values to describe, if, for example, the data stored on the tape is to be used in a two-varJable 
(or X— Y) graph, each point on the graph will require two data values to describe it: an X 
value (usually used for the graphed point's horizontal location) and a Y value (usually used 
for the vertical location). Therefore N, the first value in the tape file, will be equal to the 
number of pairs of data items in that tape file. The total number of data items in that file 
will be (2*N)-i-1. The best way to store these items is with the X and Y data values for a 
given graphed point adjacent to each other on the tape. For a two-variable graph's data, the 
tape file looks like this: 

N,X(1),Y(1),X(2),Y(2), . . . X(N-1),Y(N-1),X(N),Y(N) 

Below is a program which will write and read files with this arrangement: 



108 PAGE 

119 IHIT 

120 REM MRITE THE DATA FILE 

130 c-2e 

140 FIND 

150 HARK l,10«(2*C-fl> 

160 FIND 1 

170 WRITE C 

180 FOR I-l TO C 

190 WRITE ie«i,ie«0.i 

200 NEXT I 

210 CLOSE 

220 REM READ THE DATA FILE 

230 FIND 1 

240 READ 933: N 

250 FOR I«l TO N 

260 READ 933: X,Y 

270 PRINT X,Y 

280 NEXT I 

290 END 
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Prior to writing data to tape, the tape must be marked into files. The file be ng written to 
must be MARKed large enough to contain the data to be stored into it. Eadi data value 
stored on the tape with the WRITE command requires 10 bytes. Therefore, the number of 
bytes required for a given file is 10 times the number of data values to be stored. The storage 
arrangement described above includes an extra value containing the number of data points 
in the file. The number of data values stored in the file is the product of the number of 
graphed points and the number of data values per point, plus one. The "plut. one" reserves 
space for the extra data value (at the beginning of the file) which contains tfie number of 
data points within the file. If C is the number of graphed points and P is the number of data 
values per point, then the number of bytes of space in a tape file required to contain this 
data is 10*(P*Ch-1). Statement 150 performs this function in the above example. 

Statement 190 writes sample data onto the tape in the order described. The CLOSE com- 
mand (statement 210) should be executed after the last data item has been written to a file. 
It ensures that the data has been properly written to the tape. 

To read the tenth data point on the tape, the following program can be usee: 



lee PAGE 
lie iNiT 

129 REM WRITE THE DATA FILE CC IS THE NUMBER OF DATA PftIRS> 

130 C*20 
140 FIND e 

150 MARK l,ie«(2«C+l> 

160 FIND 1 

170 WRITE C 

180 FOR I«l TO C 

190 WRITE 10«I,ie«e.l 

200 NEXT I 

210 CLOSE 

220 REM P IS THE INDEX OF THE DATA PAIR TO BE READ 

230 P*10 

240 FIND 1 

250 READ 933: N 

260 IF P<«N THEN 340 

270 PRINT "INDEX IS GREATER THAN NUMBER OF PAIRS IN FILE" 

280 GO TO 340 

290 FOR I-l TO P-1 

300 READ f33:Q,Q 

310 NEXT I 

320 READ 933: X>Y 

330 PRINT "lOTH DATA PAIR IS "fX.Y 

340 END 
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The Q variables in statement 300 are used merely to allow the READ statement to move the 
tape; Q is a "dummy" variable having no direct usefulness. Use of the variable P (in state- 
ments 230, 260, and 290) is not necessary. The constant 10 could have been used in this 
case. The variable P was used to show how any data point within the file may be accessed 
with this method. 

The method of storing data on tape described in this section has one inherent disadvantage. 
It requires the user to keep track of how many data values are associated with each data 
point. There is no intrinsic indication on the tape whether each data point requires one, two, 
or more data values to represent it. It is imperative to remember whether there are one, 
two, or more data values for each data point within a file. 

An easier way to store data on the tape is to use the implied looping of statements which 
have arrays for arguments. For example: 



100 PAGE 

120 REM MRITE THE DATA FILE (C IS THE HUHBER OF PAIRS) 

130 C«20 

140 DIM X<C),Y<C) 

150 FIND 

160 MARK l»10*<2*C-^n 

170 FIND 1 

180 FOR I-l TO C 

190 X<I>>10«I 

200 Y<I>>10«I-»0.1 

210 NEXT I 

220 URITE C>X,Y 

230 CLOSE 

240 INIT 

250 FIND 1 

260 READ 933: N 

270 DIM A<N>fB<N> 

280 READ 033: A, B 

290 PRINT AfB 

300 END 



The data is stored on the tape in the following arrangement: 

N,X(1),X(2), . . . X{N-1), X{N),Y(1),Y(2), . . . Y(N-1,Y(N) 

All of the data is written onto the tape by statement 220 (above). All of the data is read 
from the tape by statements 260 and 280. 
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Although this method is very simple and easy to use, it has a significant disadvantage. It re- 
quires a GS whose memory is large enough to hold all the data internally at one time. Since 
the X and Y data values for a given point are located at two different places on the tape, at 
least one FOR . . . NEXT loop is required to access one data point. 



led PAGE 

118 INIT 

129 REM HRITE THE DATA FILE <C 18 THE HUNBER OF PAIR3> 

139 C«20 

149 DIM X<C>,Y<C) 

159 FIHD 9 

169 MARK l,ie»(2*C+l> 

179 FIND 1 

189 FOR I-l TO C 

199 X<I>>>19*I 

209 Y<I>-19«U9.1 

219 NEXT I 

229 HRITE C,X,Y 

239 CLOSE 

249 INIT 

259 FIND 1 

269 REM P IS THE INDEX OF THE DATA PAIR TO BE READ 

279 P»19 

289 READ 933: N 

299 DIM A(N> 

399 READ 933: A 

319 FOR I-l TO P-1 

329 READ 933:0 

339 NEXT I 

349 READ »33:B1 

399 PRINT -19TH DATA PAIR IS "|A(P>,B1 

369 END 



This kind of program is necessary unless the entire contents of both X and Y arrays have 
been read into memory. 

The first method described, with the X and Y data values for a given point adjacent to each 
other on the tape, is the superior method in cases where all data to be graphed cannot be 
contained in the GS memory at one time. If all the data can be contained in the GS memory 
at one time, then the method shown immediately above is preferable. 

Finding the minimum and maximum of the data prior to graphing is necessary when the 
data comes from tape. This can be done two ways: if all the data is contained in memory at 
one time, the min-max scanner on page 2-9 can be used; if all the data is not in memory, 
the tape can be scanned using the following kind of program (X and Y are the two data 
values for each data point, XI and Y1 are the minimums, and X2 and Y2 are the maximums). 
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lee PAGE 
lie INIT 
120 REM WRITE THE DATA FILE <C IS THE NUMBER OF DATA PAIRS) 

138 c»2e 

148 FIND 8 

158 MARK 1,18«<2»C^1> 

168 FIND 1 

178 WRITE C 

188 FOR I«l TO C 

198 WRITE 18«Ifl8«U8.1 

288 NEXT I 

218 CLOSE 

228 REM FIND MIN AND MAX OF DATA ON TAPE 

238 Xl«l.eE+388 

248 Y1-1.8E+388 

258 X2«-l.eE-i-3e8 

268 Y2— l.eE+3e8 

278 FIND 1 

288 READ 633: N 

298 FOR I-l TO N 

388 READ 633: X,Y 

318 Xl-Xl MIN X 

328 X2*X2 MAX X 

338 Yl-Yl MIN Y 

348 Y2-Y2 MAX Y 

358 NEXT I 

368 PRINT • •."MINIMUM", "MAXIMUM" 

378 PRINT •X",X1,X2 

388 PRINT "Y",Y1,Y2 

398 END 



After the FOR . . . NEXT loop at statements 290 through 350 is complete, XI will contain 
the minimum X data value, X2 will contain the maximum X data value, Y1 will contain the 
minimum Y data value and Y2 will contain the maximum Y data value. No arrays or other 
large areas of memory were reserved or required. These minimum and maximum values can 
be used directly in a WINDOW command, allowing the data on tape to be graphed one pair 
of values at a time. The technique above is important because it is a key to graphing more 
data than the GS can contain in memory at one time. 



Summary 

The procedure described above is one approach to storing data arrays on tape using READ 
and WRITE. Here is a summary of that approach. 

If the GS memory is large enough to contain all the data of interest, then the most con- 
venient way to store and retrieve data on tape is to use the inherent looping of the WRITE 
and READ commands. (In the examples below, F is the number of the file to contain the 
data and N is the number of data points. Each data point can be specified with one, two, or 
three data values. Data is contained in arrays A, B, or C, and in simple variables X, Y, or Z. 
None of the program segments below can be run as listed.) 
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For one data value per point: 
To write data: 



209 DIM A<N> 

218 FIND F 

223 MARK l,ie»(N-i-l) 

230 FIND F 

340 WRITE N,A 

258 CLOSE 



TPie tape file looks like: 

N,A(1),A(2),...A(N-1),A(N) 

To read data: 



200 FIND F 
210 READ e33:N 
220 DELETE A 
230 DIM ft<N) 
240 READ e33:A 



For two data values per point: 
To write data: 



288 DIM A(N)fB(:N> 

210 FIHD F 

228 MARK l,ie*<2«N+l) 

238 FIND F 

248 URITE N,A,B 

258 CLOSE 
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The tape file looks like: 

N,A(1),A{2), . . . A(N),B(1),B(2), . . . B(N) 

To read data: 



288 FIND F 
218 READ 633: H 
228 DELETE A,B 
238 DIM A(N),B(H> 
248 READ 633: A, B 



For three data values per point: 
To write data: 



288 DIM A<N),B(N),C<N) 

218 FIND F 

228 MARK 1, 10*(:3*N+1) 

238 FIND F 

248 URITE N,A,B,C 

258 CLOSE 



The tape file looks like: 

N,A(1) A{N),B(1), 

To read data: 



.,B(N),C(1) C(N) 



288 FIND F 
218 READ 633: H 
228 DELETE A,B,C 

239 DIM A(N),B<N>,C(N) 

240 READ 633:A,6,C 
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When data with more than one value per point is stored on tape, an additional consideration 
becomes important. When using the approach in the above six examples, thie data values for 
a given point are not placed on the tape in adjacent locations. Retrieving thie data values for 
just one point is cumbersome unless the GS memory is large enough to contain all data values 
at one time. 

If all the data cannot be contained within the GS memory at one time, then the above ap- 
proach is not suitable. Below is another method in which data values are stored and retrieved 
individually. 

For one data value per point: 
To write data: 



288 FIND F 

218 MARK 1,10*<H+1> 

220 FIND F 

238 WRITE N 

248 FOR 1=1 TO N 

258 WRITE X 

268 NEXT I 

278 CLOSE 



The tape file looks like: 

N,X(1),X(2),...X(N-1),X(N) 

To read data: 



288 FIND F 
218 READ e33:N 
228 FOR 1=1 TO N 
238 READ 933: X 
248 NEXT I 
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For two data values per point: 
To write data: 



28Q FIND F 

218 MARK 1,10*<2*N+1) 

228 FIND F 

238 HRITE N 

240 FOR l»l TO N 

250 HRITE X,Y 

268 NEXT I 

270 CLOSE 



The tape file looks like: 

N,X(1),Y(1),X(2),Y(2),...X(N-1),Y(N-1),X(N),Y(N) 

To read data: 



200 FIND F 
210 READ (?33:N 
220 FOR 1=1 TO N 
230 READ 033: X,Y 
240 NEXT I 



For three data values per point: 
To write data: 



200 FIND F 

210 MARK 1,10*(3*N+1> 

220 FIND F 

230 HRITE N 

240 FOR 1=1 TO N 

250 HRITE X,Y,Z 

268 NEXT I 
278 CLOSE 
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The tape file looks like: 

N,X(1),Y{1),Z(1),X(2),Y(2),Z(2) X(N),Y(N),Z(N) 

To read data: 



208 FIND F 
210 READ 933: N 
220 FOR 1=1 TO N 
230 READ @33:X,Y,2 
240 NEXT I 



MAG TAPE ERROR IN LINE 94 - MESSAGE NUMBER 55 



The WRITE and READ @33: commands used in this section pertain to BINARY data files. 
Numbers in binary data files are in the same form as they are internally in the GS. Data can 
also be stored and retrieved on tape with the following commands: PRINT @33: and IN- 
PUT @33: . (The primary address of 33 refers to the internal tape drive on tha GS.) These 
commands pertain to ASCII data files. Since numbers in ASCII data files arei:.trings of ASCII 
characters, ASCII data files can be read by devices outside the GS family. Binary data files 
can be read only by another GS. However, data stored in ASCII data files takas longer for 
the GS to transfer to and from tape because an additional conversion process must be per- 
formed. All the example programs in this section using the WRITE and REAt) @33: com- 
mands would remain virtually unchanged if the PRINT @33: and INPUT @33: commands 
were substituted. Only the amount of space reserved on the tape for each data value would 
need changing. In a binary file, 10 bytes must be MARKed. In an ASCII file, 18 bytes must 
be MARKed for each data value. In virtually all instances, it is best to use the WRITE and 
READ @33: commands to store and retrieve data on tape. 
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Before any graphing can be done, the nriinimum and maximum of the data or function to be 
graphed must be established. This can be done by scanning the actual data vtilues, evaluating 
the function over the specified domain of interest, or by merely estimating, n any event, 
this must be done to provide values to use in the WINDOW statement, or to atherwise 
specify what will be graphed. 

The next consideration is how the data or function will be displayed. For grtiphing one data 
array, a single valued function or other data where there is some logical connection between 
adjacent points, a line drawn through all the data points is usually appropriate. For graphing 
two independent data arrays, certain parametric functions, or other points where there is 
not necessarily a logical connection between adjacent points, some kind of point or symbol 
graph is more appropriate. Several methods will be suggested in this section. 
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LINE GRAPH 

The line graph as shown below is used to display data which one of the variables associated 
with each point is an orderly progression of values, such as would be generated by a function 
(Y = f(X)) evaluated at regular intervals throughout the X donnain of interest. A line is also 
appropriate for graphing array data items versus their indices within an array. 

The line graph, or rather the actual data curve at the heart of a line graph, is generated by 
a series of DRAW commands. An important aspect of this process is that the DRAW com- 
mand causes a line to be drawn from wherever the graphic point is currently located to the 
specified location within the window. When the first point on the data curve is drawn to, 
the graphic point is usually at some unknown or irrelevant location on the screen. So a 
MOVE to the first point to be graphed, rather than a DRAW, is appropriate. As a result, the 
FOR . . . NEXT loop which draws the remainder of the data starts with the second data 
point. A line graph of a one-dimensional array can be produced with the following state- 
ments (these must be run as part of a complete program): 



22e HINDOU e,N,Ri,R2 
239 HOME 1,Y<1> 
248 FOR I02 TO N 
258 DRAU I, Yd) 
260 NEXT I 



N is the number of data values in the array Y. 
Rl is the minimum data value in the array Y. 
R2 is the maximum data value in the array Y. 



A complete program to draw a line graph of ten random data values is shown below: 
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198 PAGE 

119 INIT 

128 H'lQ 

139 DIH Y<N) 

149 Rl>1.8E+38@ 

159 R2*-1.9E+398 

169 FOR 1=1 TO N 

178 Y(I>=RND(-2> 

189 Rl^YCI) MIN Rl 

198 R2=Y<I) MAX R2 

288 NEXT I 

218 UIEUPORT 18,128,16,99 

228 UIHDOU 8,H,R1,R2 

238 nOUE 1,Y(1) 

248 FOR 1^2 TO N 

258 DRAU hY<n 

268 NEXT I 

278 END 




A graph is sometimes easier to loolc at if it has some blank space around it. This is why the 
viewport is defined to be slightly smaller than full size in the above example (statement 210). 
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POINT AND SYMBOL GRAPH 

Point Graph 

When there is no direct relationship between adjacent data points, or no reason to connect 
them together with lines, a point graph or symbol graph is appropriate. The following ex 
ample graphs two arrays. The first value in the X array determines the horizontal location 
of the first point, the first value in the Y array determines the vertical location of the first 
point, and so forth. (The statements below must be run as part of a larger program:) 



258 UINDOM R1,R2,S1,S2 
269 FOR 1=1 TO N 
279 HOME X(I).Y(I> 
288 DRAW X<:i),Y(I) 
298 NEXT I 



N is the number of data values in each array, R1 is the minimum value in the X array, R2 is 
the maximum value in the X array, S1 is the minimum value in the Y array and S2 is the 
maximum value in the Y array. In the FOR . . . NEXT loop, there is a MOVE to each point 
followed by a DRAW to each point. Since the graphic point is already located at the point 
drawn to, only a dot, not a line, is drawn. 

A complete program to draw data points on the display is shown below: 



188 PAGE 

118 INIT 

128 RESTORE 

138 DATA ie,l-8E+3e0,-l.eE+300,1.0E+380,-1.0E+309 

140 READ N,R1,R2,S1,S2 

150 DIM X<N),Y<N> 

168 FOR 1=1 to N 

170 X(l)=RHD<-2) 

180 R1=X(D MIN Rl 

190 R2=X<I) MAX R2 

288 Y<I)=RND<-2) 

218 S1=Y(I) MIN SI 

228 S2=Y(I) MAX S2 

238 NEXT I 

248 UIEUPORT 18,128,18,98 

258 UIHDOU R1,R2,S1,S2 

268 FOR 1=1 TO N 

278 HOME X<I>,Y<I> 

288 DRAM X<I),Y<I) 

298 NEXT I 

388 END 
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This is the program's output: 




Printed Symbols 

To make individual data points distinguishable, each point's location can be marked with a 
symbol instead of just a dot. 

The simplest method is to use a standard GS character for the symbol. Witt this method, the 
graphic point is positioned on the display with a MOVE command (statement 270 in the 
examples above and below). Then the symbol is written onto the display w th a PRINT 
command, as shown in the program fragment below (these statements musi be run as part 
of a larger program): 
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258 MINDOH R1,R2,S1,S2 
268 FOR 1=1 TO N 
279 nOUE XCDjYd) 
288 PRINT "+"5 
298 NEXT I 



Although the character "+" is shown in the example, any character can be used. If these 
statements (above) are used, the center of the printed character will be above and to the 
right of the desired location on the display (see diagram below). 



OOOOO 

oo«oo 

OO^OO 




oo#oo 
oo«oo 

OOOOO 

oooo 



MOVE COMMAND 
Positions Graphic Point Here. 



The above diagram shows that the MOVE command positions the lower left corner of the 
character. If the center of the printed character is to coincide with the point specified by the 
MOVE command, the graphic point must be re-positioned slightly after the MOVE command 
(statement 270) and before the PRINT command (statement 280). The statements added 
in the following example (273, 278, and 285) center the "+" over the graphic point. 



258 MINDOI*! R1,R2,S1.S2 

268 FOR 1=1 TO N 

278 MOUE X( I. :*,¥<: I) 

273 SCALE 1,1 

278 RMOUE -8.5*1.55,-8.5*1.88 



282 RMOUE 8.5*1.55,6.5*1.1 
285 UINDOU R1,R2,S1,S2 
298 NEXT I 
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Since the characters written by the PRINT command are always the same sl^^e, the graphic 
point must always be re-positioned the same distance, regardless of how the window has 
been defined. The SCALE 1 ,1 command at statement 273 defines a new data space to fill 
the viewport. Within this new data space, 1 data unit is the same length as 1 GDU. The 
RMOVE command is then used to re-position the graphic point relative to ils current posi- 
tion. In order to center the character, the graphic point should be moved haif a character 
width to the left and half a character height down. The RMOVE command nt statement 278 
performs this function. After the character is printed, the window must be restored to its 
previously defined limits. If it is not restored, the remainder of the graphed points will be 
placed inaccurately on the display. 

Care must be exercised if the above technique (PRINTed characters as symbols) is used when 
a default (full size) viewport has been defined. If the graphic point is at the very top, bottom, 
left or right edge of the physical display when the character is printed, the character will 
not be printed in the correct location. This inaccuracy is prevented whenever the defined 
viewport is less than full size. The largest viewport which still prevents this inaccuracy from 
occurring is defined with the following command: 

VIEWPORT 2,128,2,98. 



Drawn Symbols 

Another way to place a symbol at the location desired is to actually draw it. This is done 
with a series of relative moves and draws from the location the symbol indicates. The following 
example draws a diamond to indicate a location: 



258 I4IHD0U R1,R2.S1,S2 

269 FOR I«l TO N 

279 MOUE X<I),Y(I> 

28d SCALE 1,1 

298 RMOUE 1,8 

388 RDRAU -1,-1 

318 RDRAM -1,1 

328 RDRAM 1,1 

330 RDRAW 1,-1 

340 RMOUE -1,0 

358 UINDOU R1,R2,S1,S2 

368 NEXT I 
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The SCALE 1,1 at statement 280 ensures that the symbols will always be the same size re- 
gardless of how the window and viewport have been defined. Line 290 ensures that the 
symbol is centered over the location to be indicated. Lines 300 through 330 draw the symbol. 
Line 340 restores the graphic point to its location before the symbol was drawn. Line 3E)0 
restores the window so that subsequent data points will be graphed correctly. 

Below is the complete program and the output it produces. 

lee PAGE 
lie iNiT 

128 RESTORE 

139 DATA 10,l.eE+3e0,-l.eE+300,1.0E+309,-1.0E+3e0 

140 READ N,R1,R2,S1,S2 
150 DIM X<N),Y<N) 

168 FOR I«l TO N 

178 X(I)«RHD<-2> 

180 Rl'Xd) MIN Rl 

190 R2«X(I) HAX R2 

200 Y<I>=RND<-2) 

210 Sl=Y<n MIN SI 

220 S2=Y(I) MAX S2 

230 NEXT I 

240 UIEWPORT 10,120,10*90 

250 UIHDOH R1,R2,S1,S2 

260 FOR 1=1 TO N 

279 MOUE X<I),Y<I) 

280 SCALE 1,1 
290 RMOUE 1,0 
300 RDRAU -1,-1 
310 RDRAU -1,1 
320 RDRAU 1,1 
330 RDRAU 1,-1 
348 RMOUE -1,0 

358 UINDOU R1,R2,S1,S2 
368 NEXT I 
378 END 
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Drawn symbols are subject to clipping. Printed symbols are not. 

The symbol size can be made proportional to a data value or function result as shown in the 
following program fragment: ^ 



258 
2€e 
278 



288 
298 
388 
318 



348 
358 



HINDOH R1,R2,S1,S2 
FOR I»l TO N 
HOME X<1),Y(I) 



SCALE 
RHOUE 
RDRAU 
RDRAM 
328 RDRAU 
338 RDRAU 
RHOUE 
UINDOU 



368 NEXT I 



111 
Z<I>,8 
-Z<I>,-2<I) 
-Z<I>,2<I) 
Z(I),2<I) 
2<I),-2<I) 
-2<I),8 
RlfR2»Sl,S2 



PLOT 50 GRAPHIC PROGRAMMING 



REV A, SEPT 1978 



3-9 



GRAPHING 

POINT AND SYMBOL GRAPH 



More than one kind of synnbol can be drawn by a program. In addition, the actual symbol 
can be selected by a data value. Using the GOSUB . . . OF . . . command, as shown below, 
makes this very easy. 



258 HINDOU R1,R2,S1,S2 

2€e FOR I>1 TO N 

279 NOUE X<I),Y(I) 

288 SCALE 1,1 

298 GOSUB Z<I> OF 588,688,790 

398 UINDOU R1,R2,S1,S2 

318 NEXT I 

328 END 



588 REM DRAM A DIAMOND SYMBOL 



559 RETURN 

688 REM DRAH A SQUARE SYMBOL 



658 RETURN 

788 REM DRAH A TRIANGLE SYMBOL 



758 RETURN 
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MULTI-LINE GRAPHS 

If there are several lines on one graph, a very good technique to identify each line is to draw 
a symbol at each graphed point. A program like this: 



22e UINDOU e,N,Rl,R2 
238 nOUE 1,A<1) 
248 GOSUB 488 
258 FOR 1=2 TO N 
268 DRAU I»A<I) 
278 GOSUB 488 
288 NEXT I 



488 REM PRINT SYMBOL 
418 PRINT "+"; 
428 RETURN 



will produce a line like this: 
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To properly position the printed character, the correction described on page 3-6 must be 
included. The corrected program segment is shown below: 



228 HIHDOU e,N,Rl,R2 
238 NOUE l,A(i> 
248 GOSUB 488 
258 FOR 1-2 TO N 
268 DRAU I,A(I> 
278 GOSUB 488 
288 NEXT I 



488 RE« PRINT SYHBOL WITH CORRECTED POSITION 

485 SCALE 1,1 

418 RHOUE -8.5*1.55,-0.5*1.88 

428 PRINT •+"} 

438 RHOUE 0.5*1.55,8.5*1.88 

448 HINDOH 8,N,R1,R2 

450 RETURN 



Below is a complete program which uses the above technique. The program output is shown 
also. 

100 PAGE 

110 INIT 

120 RESTORE 

130 DATA 18,1.0E43O0,-1.0E^300 

148 READ N,R1,R2 

150 DIN A(N) 

160 FOR I>1 TO N 

170 A<I)«It2 

180 R1«A(I> HIN Rl 

190 R2»A(I> MAX R2 

280 NEXT I 

210 UIEMPORT 10,120,10,90 

220 UINDON 0,N,R1,R2 

230 HOME IjACl) 

240 GOSUB 400 

250 FOR 1=2 TO N 

260 DRAU I,A<I> 

270 GOSUB 406 

280 NEXT I 

290 END 

400 REM PRINT SYMBOL WITH CORRECTED POSITION 

405 SCALE 1,1 

410 RHOUE -0.5*1.55,-0.5*1.88 

428 PRINT •+"; 

438 RHOUE 8.5*1.55,0.5*1.88 

440 WINDOW 0,N,R1,R2 

458 RETURN 
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Even with this correction included, the characters are not positioned with their centers ex- 
actly over the desired point. If the position of the symbol must precisely coincide with the 
indicated location, drawn symbols are more appropriate than printed symbols. 
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OTHER TYPES OF GRAPHS 

Another way to represent certain kinds of data is with vertical or horizontal rectangles in- 
stead of lines and points. 









r— 1 


1—1 















These are called bar charts or histograms. They are really a special type of symbol graph. 
The symbol in this case is a rectangle or line whose height is proportional to the data value 
being represented. One end of the rectangle or line is usually on a base line (as in the first 
example graph, above). However, depending upon the data being presented, this will not al- 
ways be the case (as in the second example graph). This second technique is sometimes used 
to present the performance range of a variable at a given time, such as daily stock market 
averages. 
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Here is a way to draw vertical lines whose lengths represent data values: 



2ee HINDOM 9,N»l.l,e,R 

218 AXIS 

228 FOR 1«1 TO N 

238 tlOUE 1,8 

248 DRAW I, Ad) 

258 NEXT I 
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The vertical lines can be changed to vertical bars by replacing the DRAW statement at state- 
ment 240 with a subroutine branch. 



2ee utNDOH d,N*i.i,e,R 

218 AXIS 
228 FOR I>i TO N 
238 nOUE 1,8 
248 GOSUB 488 
258 NEXT I 



488 RDRAU -8.5,8 
418 RDRAU 8, Ad) 
428 RDRAM 8.5,8 
438 RDRAU 0,-A<I> 
448 RETURN 
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The heights of the bars are the same as the heights of the lines in the previoiis example. 

Here is the complete program which generated the output shown above: 

18e PAGE 

118 INIT 

128 N«18 

138 R*~1.8E-t-38e 

148 DIM A<N> 

158 FOR I«l TO N 

168 A<I>-SQR(I) 

178 R>A<I> HAX R 

188 NEXT I 

198 UIEHPORT 28,118,28,88 

288 UINDOU 8,N»l.i,8,R 

218 AXIS 

228 FOR I>1 TO H 

238 HOME 1,8 

248 GOSUe 488 

258 NEXT 1 

268 END 

488 RDRAU -8.5,8 

418 RDRAM 8,A(t> 

428 RDRAM 8.5,6 

438 RDRAU 8,-A<I> 

448 RETURN 



In the previous example, the height of each bar represented a value contained in a specific 
array item, i.e., the value of one variable. Often this bar graph technique will be used to 
graph a continuous variable, such as the distribution of 50 occurrences of a random number 
which can have any value between and 1. The next example shows how th s can be done. 

188 PAGE 

118 INIT 

128 S«ie8 

138 R»"1.8E+3e8 

148 DIM A<18) 

158 A»8 

168 FOR I-l TO S 

178 J«IHT(RND<-2)*18)+1 

188 A<J)«A(J)+1 

198 R-ACJ.^ MAX R 

288 NEXT I 

218 UIEHPORT 20,110,20,88 

228 UINDOU 6,ll,0,R)|:i.l 

238 AXIS 1,1 

240 FOR 1=1 TO 10 

250 MOUE 1,6 

268 GOSUB 400 

278 NEXT I 

286 END 

488 RDRAU -1,0 

418 RDRAU e,A<I) 

428 RDRAU 1,6 

438 RDRAU 6,-A(I> 

440 RETURN 
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The loop which actually does the graphing (statements 240 through 270) is similar to pre- 
vious examples. The width of the bars has been increased until the bars are now adjacent to 
each other. The array A is filled by statements 160 through 200. A(1) contains the quantity 
of random numbers whose values fell between and .1, A(2) contains the quantity of ran- 
dom numbers whose values fell between .1 and .2, and so forth. The MAX function is use- 
ful to find the maximum number of incidences in any category (statement 190). The re- 
sulting maximum value (R) is used in the WINDOW command in statement 220. 
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Graphing the percentage each category is of the total number of incidences (50 in this 
example) requires only a vertical rescaling determined by the data. The quantity of incidences 
in each category is divided by the total number of incidences to yield a decimal fraction. 
This is multiplied by 100 to yield a percentage. The graph looks the same, so only the listing 
is shown as the example. 

180 PAGE 

118 INIT 
120 S«50 

138 R«-1.0E+390 

140 DIM A<10) 

1S0 A«0 

160 FOR 1=1 TO S 

170 J'INTCRNDC-S)*!©)*! 

180 A(J>«A(J)+1 

190 R=A<J) MAX R 

200 NEXT I 

210 MIEMPORT 20,110,20,80 

220 WINDOW 0,11,0,R.''501:180*1.1 

230 AXIS 1,5 

240 FOR 1=1 TO 10 

250 MOUE 1-1,0 

260 GOSUB 400 

270 NEXT I 

280 END 

400 RDRAW 0,A(I)/50.*100 

410 RDRAW 1,0 

420 RDRAW 0,-A(I)/50*100 

430 RETURN 

Data expressed in this percentage form can be graphed in another way. The height of each 
vertical bar, now a percentage, can be interpreted to be the width of a slice of a circle. This 
produces a "pie chart", shown in the following example. The same data is being used. 

lee PAGE 

119 INIT 
128 S«50 

138 R*-1.8E-^38e 

148 DIM A(10) 

150 A«0 

160 FOR I>1 TO S 

170 J=INT<RND<-2)»10)+1 

180 A<J)»A<J>+1 

190 R»A<J) MAX R 

288 NEXT I 

218 UIEHPORT 28,88,28,80 

220 WINDOW -1,1,-1,1 

225 SET DEGREES 

230 MOUE 1,0 

240 FOR 1=1 TO 10 

242 FOR T«10 TO 360 STEP 10 

244 DRAW COS<T),SIN<T) 

246 NEXT T 

250 B=0 

260 FOR I«l TO 10 

270 B=B+360«(A(I)/50) 

288 HOME 8,8 

298 DRAW COS(B),SIN(B) 

398 NEXT I 

318 END 
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Up to this point, the discussion has covered graphs where the actual function or data is pre- 
sented. None of the data has been manipulated between entry and graphing. However, there 
will be many instances where the actual raw data or function will not be of interest unless 
it is suitably transformed. Three examples: 

temperature data taken in Fahrenheit degrees but used in a formula wliich requires 
Celsius degrees; 

data taken in miles per hour but used in the form of meters per seconc; 

data taken in the form of dollars per hundred weight but used in the form of francs 
per kilogram. 

There will be many situations where the transformation is neither linear noi simple. For 
example, in a laboratory situation, temperature might be measured with a msistor whose 
resistance varies as a function of its surrounding temperature. Thus the insttumentation 
which supplies data to the GS will be sending data values in the form of ohms. The GS pro- 
gram handles data in the form of degrees Celsius. The formula for the relationship between 
ohms and degrees Celsius over the range of interest is used as a transformation. During data 
editing and graphing, the data being dealt with will then be degrees, not ohns. 
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EXAMPLES 

In the three examples which follow, lines 100 through 210 are identical. They fill array A 
with data values and place the smallest and largest of these values into Ml and M2 respectively. 
And, in all three examples, lines 250 through 280 perform identical functions: graphing the 
data in array A. 



In the first example, the data is graphed with the index of the array item on the horizontal 
axis and the actual array value on the vertical. Both scales are linear. 

186 PAGE 

lid INIT 

128 UIEUPORT 28,118)28,88 

138 N>18 

148 DIM A(N) 

158 Hl«1.8E+388 

168 H2>-1.8E-f388 

178 FOR I«l TO N 

188 A(I>*It2 

198 H1"H1 HIN Ad) 

288 n2>n2 MAX A<I) 

218 NEXT I 

228 REM GRAPH ACTUAL DATA (HORIZ 8. UERT.) 

238 UIHDOU 1,N,H1,H2 

248 AXIS 

258 HOUE 1,A(1) 

268 FOR 1=2 TO N 

278 DRAM I, Ad) 

288 NEXT I 

298 END 
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In the next example, the horizontal information is as before, the index of tPe array item. 
The vertical information is not the actual value contained in the array item but the log to 
the base 10 of the value in each array item. 
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188 PAGE 

118 INIT 

128 VIEUPORT 28,110,28,88 

138 N'le 

148 DIH A(H> 

158 Hl>1.8E-^388 

1£8 n2«'-1.8E+388 

178 FOR 1«1 TO N 

188 A<I)»It2 

198 H1«H1 MIN A<I> 

288 n2*H2 MAX A<I> 

218 NEXT I 

228 REH UERTICAL DATA TRANSFORMED BY LOG BASE 

238 UINDOU l,N,LGT<Ml>,LGT<n2> 

248 AXIS 

258 HOVE 1,LGT<A<1>) 

268 FOR I»2 TO N 

278 DRAM I,LGT<A<I)) 

288 NEXT I 

298 END 



16 
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In the third example, the logs of both the array item index and the value contained in the 
array item are graphed. 

lee PAGE 

118 INIT 

lae MIEUPORT 28,lie>28,88 

138 N>i8 

148 Din A<N> 

1S8 H1>1.8E*388 

168 H2*-1.8E4^388 

178 FOR 1=1 TO N 

188 A<I)»It2 

198 H1«M1 HIN A<I) 

288 H2sn2 MAX A<I> 

218 NEXT I 

228 REM BOTH H0RI2. 8< WERT. DATA TRANSFORMED BY LOG BASE 18 

238 HIHDOH LGT<1),LGT<N),LGT(M1),LGT<M2> 

248 AXIS 

258 HOUE LGT<1),LGT(A<1)) 

268 FOR I«2 TO N 

278 DRAM LGT(n,LGT<A(I)) 

288 NEXT I 

298 END 
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In all of the previous examples, the type of transformation used is reflected in three areas: 

41 In the WINDOW command (line 230 in each example). The transformation is used to 
make sure that the data completely fills the specified viewport. Because each example 
uses a different transformation, the viewport in each case is "looking at" slightly dif- 
ferent areas of the user's data space. As a result of the transformation being reflected 
in the WINDOW statement, the starting and ending points of all three data curves are 
in the same place on each graph. 

♦ In the MOVE command (line 250 in each example). As described previously, this state- 
ment is necessary so that the data curve will start at the first data point, not at where- 
ever the graphic point is when the program is run. The transformation must appear here 
for the data curve to start in the appropriate location. 

* In the DRAW command (line 270 in each example). Since this is the statement which 
actually causes the data curve to be drawn, the transformation must appear here so that 
the curve is drawn as desired. 
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TWO APPROACHES 

There are two significantly different approaches to this transformation process. In one 
approach, the data is stored and edited in the GS in its original incoming form. The data is 
transformed to a new form only when it is graphed. This approach is appropriate if the data 
in its incoming form is the primary concern. The way in which it is graphed is of secondary 
interest only. This approach was used in the group of three examples. A polar graph is an- 
other example. It is always appropriate to deal with polar data in its original form of angle 
and radius. But to graph it on the GS, it must be transformed into cartesian coordinates. As 
in the three examples, this transformation must be reflected in the WINDOW command 
(statement 240, below) in the initial move to the starting point of the data curve (statement 
270, below), and in the DRAW command which actually draws the curve (statement 290, 
below). 

In a polar graph, as in some other types, the transformation used must also be reflected in 
the minimum-maximum determination (statements 190, 200, and 230, below). This is be- 
cause the data minimum and maximum do not coincide with minimum and maximum hori- 
zontal and vertical locations on the screen. (This is the case in the three examples.) 

180 PAGE 

lie IHIT 

128 SET DEGREES 

138 Din R(18),T(ie> 

148 H1>1.8E4388 

158 n2>-1.8E>388 

1S8 FOR I«l TO 18 

178 T(I)»36»I 

188 R<I>*I 

198 Hl-Hl niN R(I> 

288 n2«H2 NAX R(I> 

218 NEXT I 

228 REM NOU FIND MAX I MUM RADIUS 

238 N3>ABS<H1> MAX ABS<M2> 

248 HINOOM -H3,H3,-M3,M3 

258 UIEUPORT 28,86,28,88 

268 AXIS 

278 MOUE R(1)«C0S<T(1)),R(1)«SIN<T<1)) 

288 FOR I>2 TO 18 

298 DRAH R<I>«COS<T<I)),R<I>«SIN<T<I)) 

388 NEXT I 

318 END 
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Polar graphs have another special characteristic. They require equal horizontal and vertical 
scaling. This means that a vertical user data unit must have the same displayed length as a 
horizontal user data unit. If this is not the case, objectionable distortion will result. For ex- 
ample, a circle might be drawn as an ellipse. This requirement can be satisfied by using the 
SCALE command with equal arguments. Another solution, shown in the polar graph ex 
ample, is to make sure that the window and viewport have the same aspect ratio. This is 
another way of saying that their shapes are proportional. In the above example, both the 
window and viewport are square. As a result, the spiral data curve is undistorted. 

In the second approach to the transformation process, the data is transformed prior to 
storage. This approach is desirable when the form in which the original data is received is 
never appropriate or convenient to use (such as when the incoming data is in the form of 
degrees Fahrenheit and is to be used in the form of degrees Celsius). In this approach, the 
actual transformation is done when the data is input. This means that the transformation 
needs to be used only when the data is transformed for storage (statement 210 in the ex- 
ample below). The min-max determination, the WINDOW and the MOVE to the first point 
all are performed on the transformed data. This approach is less cumbersome than trans 
forming the data just prior to graphing and is more convenient to use when the situation 
allows. 
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118 INIT 

l£e giEUPORT 28,120,20,88 

138 N-IS 

148 Hl»1.8E-t-388 

158 H2«-1.8E-^388 

168 DIN C(N> 

178 FOR I«l TO N 

188 REM STATEMENT 198 SIMULATES INPUT (»D: 

198 F»RND<"2)»188+32 

288 REM CONUERT INPUT DATA FROM FAHRENHEIT TO CELSIUS 

218 C<I)=5*<F-32)/9 

228 M1=M1 MIN C<I> 

238 M2«M2 MAX C<n 

248 NEXT I 

258 UIHDON 8,H,M1,M2 

268 AXIS 

278 MOUE IjC(l) 

288 FOR 1=2 TO N 

298 DRAM I,C(I) 

388 NEXT I 

318 END 
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USEFUL TYPES 

Occasionally, the transform which operates on the incoming data must be variable. For ex- 
ample, a different temperature probe might be used for another run in the same experiment. 
If one program is to be used to graph data passed through a variety of transforms, it is ap- 
propriate to place the transform in a defined function. The following is an example of this. 



lie iNiT 

115 OEF FHA(ft)«5»<A-32)/9 
IZe UIEUPORT 29,128,20,89 



28e REH CONUERT INPUT DATA FROM FAHRENHEIT TO CELSIUS 
218 C<I)«FNA<F> 
228 H1«H1 HIN C<I> 



The above example is identical to the one before it except that the transform used is defined 
in a function (in statement 115). Each subsequent use of the transform will be identical — 
merely a function call as in statement 210. So by changing one statement, the transform 
used by the entire program can be changed. The next section will illustrate a particularly 
useful application for this capability. 



There are several classes of transformations which are commonly used for transforming data. 
(In the following formulae: X,Y,R, and T represent variables; A and B represent constants.) 



TRANSFORMATION 

Log to the base 10 

Log to the base e 

Polar (R = radius, T = angle) 

Exponential 

Power 

Logit 



EXAIVIPLE OF USAGE 

DRAW X,A*LGT(B*Y) 

DRAW X,A*LOG(B*Y) 

DRAW R*COS(T),R*SIN(T) 

DRAW X,A t (Y-i-B) 

DRAW X,YtA 

DRAW LOG(X/(1-X)),YforO<X<1 
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AXIS COMMAND REVIEW 

An axis or grid makes graphed data much easier to understand. This section describes two 
classes of ways to add axes and grids to a graph: with use of the AXIS command, and with- 
out the use of AXIS. For most graphs, use of AXIS will be appropriate. Techniques which 
use the AXIS command are discussed first. However, there are some types of data for which 
use of AXIS is inappropriate, such as logarithmic and polar data. So the other class of pro- 
cedures discussed is how to make axes and grids without using AXIS. 



Without Arguments 

The simplest way to add axis lines to a graph is with the AXIS command, der;cribed in 
Section 1. Here is a brief review. Please enter and run the following program: 

lee PAGE 
lie iNiT 

126 UIEHPORT 5,55,55,95 

138 AXIS 

148 REM 

158 UIEWPORT 75,125,55,95 

160 UIKDOU -188,180,58,188 

178 AXIS 

188 REN 

190 UIEHPORT 5,55,5,45 

288 MINDOH 58,188,-188,180 

210 AXIS 

220 REM 

230 UIEMPORT 75,125,5,45 

248 I4IND0H -25.75,-25,75 

258 AXIS 

268 HOME 

278 END 



Shown below is the output produced by the above program: 
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In the above program, the AXIS command is used four times. Each time it is used, no argu- 
ments are specified. When an AXIS command is executed with no arguments, the locations 
of the resulting axis lines are determined by the last defined window. With no arguments, 
AXIS draws each axis line through the data minimums specified in the last WINDOW com- 
mand. However, if zero lies within either data range, the corresponding axis line is drawn 
through zero instead of the minimum. The above example program is a demonstration of 
how WINDOW determines the default locations of the AXIS lines. 

When AXIS is first used (statement 130), only the default window (0,130,0,100) is defined. 
(The VIEWPORT command at statement 120 causes the window which contains the axis 
lines to be placed in the upper left part of the display.) In the second use of AXIS in the 
above example (the upper right set of axis lines in the above output), the WINDOW com- 
mand at 160 places zero in the middle of the horizontal range. In the third use of AXIS 
(the lower left axis lines in the above output), zero is in the middle of the vertical data range. 
In the fourth use of AXIS, zero is near the lower end of both data ranges. 
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With Arguments 

AXIS can also be used with two or four arguments. In either of those cases, the two argu- 
ments immediately following the AXIS command specify the distance in ua^r data units be- 
tween tic marl<s. The first argument refers to the horizontal axis tic marks and the second 
argument refers to the vertical axis tic marks. The following program illustrates how these 
arguments change the AXIS command's function. 

lee PAGE 

lie yiEMPORT 5,55,55,95 

lae MiNDOu ie,iee,-ide,iee 

138 AXIS 18,26 

148 UIEHPORT 75,125,55,95 

158 AXIS 18,8 

168 UIEHPORT 5,55,5,45 

178 AXIS 18,8,98,-58 

188 HONE 

198 END 
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Both axis lines in the upper left of the display (drawn by the AXIS command at statement 
130) have tic marks. Tic marks are not drawn on an axis line if the corresponding argument 
in the AXIS command is zero. In statement 150, the second argument of the AXIS com- 
mand is zero. As a result, the vertical axis in the upper right set of axes lines does not have 
tic marks. 

The third and fourth arguments of the AXIS command specify the crossing point of the 
axes. The third argument specifies the horizontal location of the vertical axis. The fourth 
argument specifies the vertical location of the horizontal axis. In spite of their being drawn 
in an identical window, the set of axis lines in the lower left of the display cross at a dif- 
ferent location than the other two sets of axis lines shown. The crossing point was specified 
by the third and fourth arguments of the AXIS command in statement 1 70. 
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WITHOUT AXIS COMMAND 

Another way to place an axis on the screen is to actually draw the lines using MOVE and 
DRAW. The remainder of this section describes how this is done for linear, logarithmic, and 
polar axis types. Understanding the material in the remainder of this section is necessary 
only for an application which requires an axis different from that produced by the AXIS 
command. If the axis requirements are adequately satisfied by the AXIS command, you 
may want to skip to the beginning of the next section. 



Without Tic Marl(s 

The next example uses MOVE and DRAW to place axis lines on the screen. For the vertical 
axis line, all this entails is moving to the point where the vertical axis and Uie Y data mini- 
mum meet (X and -500 in this case) and drawing to the point where the vertical axis and 
the Y data maximum meet. A similar process is used for the horizontal axis. Inherent in a 
program of this nature is the location for the crossing point of the two axis lines, which is 
X = 1950 and Y = in the next example. 

lea PAGE 

118 uiEHPORT 2e,ua,2a,8e 

12d UINDOU 1958, 1988, -see, 588 

138 REM VERTICAL AXIS LINE 

148 HOVE 1958,-588 

158 DRAU 1958,588 

1«8 REN HORIZONTAL AXIS LINE 

178 HOME 1958,8 

188 DRAU 1988,8 

198 HOHE 

288 END 
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With Tic Maries 

The addition of tic marks mal<es the axis lines more helpful in understanding the data graph. 
The best way to add tic marks is to use a MOVE and a DRAW in a FOR . . . NEXT loop. 
This is shown in the next example. 
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lOd PAGE 

lie UIEHPORT 28,116,20,80 

126 UINDOU 1950,1980,-500,508 

130 REH VERTICAL AXIS LINE 

140 HOME 1950,-500 

158 DRAU 1950,500 

168 REH HORIZONTAL AXIS LINE 

170 HOME 1950,0 

188 DRAM 1980,0 

198 REM VERTICAL AXIS TICS 

200 REJ1 TIC LENGTH » 2V. OF RANGE 

210 T'*(1980-1950)*0.01 

220 FOR I=-500 TO 500 STEP 108 

230 HOME 1950-T,I 

248 DRAU 1950+T,I 

250 NEXT I 

260 REN HORIZONTAL AXIS TICS 

278 T=(500— 500>*e.01 

288 FOR I«1950 TO 1988 STEP 5 

290 MOUE I,-T 

380 DRAH I,T 

316 NEXT I 

328 HOHE 

338 END 
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The axis crossing point and the distance between tic marks must be specified. With this 
technique, the distance between tic marks is implied by the STEP size in each FOR state- 
ment. 

With the AXIS command, the actual size of the tic mark is defined to be 1% of the window 
size. With the technique in the above example, it must be explicitly specified. In the above 
example, it is 2%. (The length of the tics on the horizontal axis is 2% of the vertical data 
range.) The variable T contains a value equal to 1%: half of a horizontal axis tic is below the 
horizontal axis and half is above it. The total length is then 2%. This value can be made any 
appropriate length by changing statements 210 and 270. In the above example, the tics on 
the vertical axis are partially clipped because each tic's left half is outside the window. 



Unaligned Tic Marl<s 

Here is the same program with slightly different data. 

199 PAGE 

119 UIEUPORT 29,119,29,88 

129 HINDOH -23,87,-25,25 

139 REN UERTICAL AXIS LINE 

149 HOME 8,-25 

159 DRAH 9,25 

169 REH HORIZONTAL AXIS LINE 

179 HOME -23,9 

189 DRAU 87,9 

198 REM UERTICAL AXIS TICS 

298 REM TIC LENGTH ' 2'/. OF RANGE 

218 T=(87— 23)*8.81 

228 FOR I=-25 TO 25 STEP 18 

238 HOME 8-T,I 

248 DRAH 8-t'T,I 

258 NEXT I 

268 REM HORIZONTAL AXIS TICS 

278 T«<25~25)*9.ei 

288 FOR I«-23 TO 87 STEP 18 

298 HOME I,-T 

399 DRAH I,T 

319 NEXT I 

329 HOME 

339 END 
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In the above example, the tics are aligned with the window, not the axis intersection point. 
This is caused by each FOR . . . NEXT loop using the data minimum for a starting point. 
For example, the FOR statement at line 220 specifies a starting value of -2b, the vertical 
data minimum. This will always produce a tic mark on the lower end of the vertical axis, at 
the bottom edge of the window. 



Alignment Correction 

If the tics are always to be aligned with the axis crossing point, the followinn correction can 
be used: 
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215 U«<25/19-INT<25/10))*19 
229 FOR I—25+U TO 25 STEP 19 



275 U«<23/19-INT(23/19>)«19 
289 FOR I»-23+U TO 87 STEP 10 



(Statements 215 and 275 are added; statements 220 and 280 are changed.) 

This correction changes the starting point of each FOR . . . NEXT loop. The change is just 
enough to place a tic mark at the intersection point of each axis line. A more complete 
explanation of the correction follows the next example. Here is what the complete pro- 
gram looks like: 

199 PAGE 

119 MIEUPORT 29,119,29,89 

129 HINDOU -23,87,-25,25 

139 REM UERTICAL AXIS LINE 

149 HOUE 9,-25 

159 DRAU 9,25 

169 REH HORIZONTAL AXIS LINE 

179 HOME -23,9 

189 DRAU 87,8 

199 REH UERTICAL AXIS TICS 

299 REH TIC LENGTH ■ 2'/. OF RANGE 

219 T«<87~23)«0.81 

215 U«<25/10-INT(25/10))*10 

220 FOR I=-25+U TO 25 STEP 18 
230 HOME 0-T, I 

240 DRAH 0-t-T, I 

250 NEXT I 

260 REH HORIZONTAL AXIS TICS 

270 T«<25~25)*O.01 

275 U»(23/10-INT<23/10))»10 

280 FOR I— 23+U TO 87 STEP 10 

290 HOME I,-T 

390 DRAU I,T 

319 NEXT I 

329 HOHE 

339 END 
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In each FOR . . . NEXT loop, the value placed in U is the distance between the edge of the 
window and the first tic mark. 



General Correction 

To show how this correction is applicable to the general case, the next examjjle replaces the 
number constants with variables. Here is a list of the variables used: 

Ml = horizontal data minimum 

M2 = horizontal data maximum 

N1 = vertical data minimum 

N2 = vertical data maximum 

X = horizontal location of vertical axis 

Y = vertical location of horizontal axis (X,Y is the crossing point of the two axis lines) 

11 = distance between tics, horizontal axis 

12 = distance between tics, vertical axis 
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lee PAGE 

lie MIENPORT 20,110,26,86 

113 RESTORE 

115 DATA -23,87,-25,25,9,9,10,10 

11? READ HI, M2,N1,N2,X,Y, 11,12 

120 HIHDOH ni,l12,Nl,N2 

130 REM VERTICAL AXIS LINE 

140 HOUE X,N1 

150 DRAH X,H2 

160 REN HORIZONTAL AXIS LINE 

170 HOUE «1,Y 

180 DRAM H2,Y 

198 REM MERTICAL AXIS TICS 

288 REM TIC LENGTH = 2'4 OF RANGE 

218 T=(M2-M1)*0.01 

215 U=<<Y-N1)/I2-INT<<Y-N1>/I2)>*I2 

220 FOR I«N1+U TO H2 STEP 12 

230 HOVE X-T,I 

240 DRAM X4T,I 

250 NEXT I 

260 REM HORIZONTAL AXIS TICS 

270 T«<N2-N1)*8.01 

275 U«<(X-M1)/I1-INT<(X-M1>/11))*I1 

280 FOR I«M1+U TO M2 STEP II 

290 HOME I,Y-T 

380 DRAW I,Y>T 

310 NEXT I 

320 HOHE 

330 END 

(Since the output from this program is identical to the output from the one before it, no 
output is shown.) 



As stated before, the corrections included at statements 215 and 275 merely find the dis- 
tance between the edge of the window and the first tic. For the case of the vertical axis 
correction (line 215), here is a detailed description of the process: 

1. Find the distance between the axis crossing and the data minimum (in this example it 
isY-NI). 

2. Divide this distance by the distance between tics (in this case I 2). This quotient is the 
total number of full and partial tic intervals which will fit between the vertical data 
minimum and the axis crossing point. 

3. Subtract from this number its integer part. What remains is the distance between the 
edge of the window and the first tic, expressed as a decimal fraction of a tic interval. 

4. Multiply this fraction by the distance between tics. The product is the desired distance. 

This program duplicates the function of the AXIS command, a capability which will be 
useful when labeling tic marks. 
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Minor Tic IVIarks 

The addition of minor tic marl<s, i.e., marks that are shorter than the major tic marks, can 
often make a graph clearer. If the following statements are added to it, the fsxample pro- 
gram above will draw minor tic marks. (There are four minor tic intervals for each major 
tic interval.) 



242 FOR J-1 TO I+I2 STEP 12/4 
244 nOVE X,J 
246 DRAU X^T,J 
248 NEXT J 



392 FOR J=I TO I+Il STEP 11. -'4 
384 HOME J.Y 
3e€ DRAM J,Y^T 
see NEXT J 



I ' ' ' > ' ' 



«''>■'»> ' ''>''' t ''» I ''' I ■'■ I ■■' I 
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Only statements 242 through 248 and 302 through 308 were added. For the vertical axis, 
statements 242 through 248 comprise an inner loop which draws the minor tics in the same 
manner that the outer loop (statements 220 through 250) draw the major tics. Statements 
302 through 308 serve a similar function for the horizontal axis. 



Using RDRAW 

Another way to draw axis lines with major tic marks is to use the relative RDRAW com- 
mand instead of the absolute DRAW. All the examples so far have used DRAW. There will 
be a few instances where the use of RDRAW and RMOVE is appropriate for drawing an 
axis. However, in most cases, using MOVE and DRAW will produce a program which oc 
cupies slightly less space in machine memory and which executes faster. The example below 
draws axis lines and tic marks using RDRAW: 

lee PAGE 

lie uiEUPORT 2e,ne,28,8d 

113 RESTORE 

115 DATA -23,87,-25,25,8,0,10,10 

117 READ l11,n2,Nl,N2,X,Y,Il,I2 

128 UINDOU H1,N2,N1,N2 

138 REH UERTICAL AXIS 

148 T«<n2-ni>«8.81 

158 U»<<Y-N1)/I2-INT<<Y-NU/I2))*12 

168 NOUE X,N1 

178 RDRAU 8,U 

188 FOR I-U+Nl TO N2 STEP 12 

198 RDRAU 8,12 

288 RDRAU T,8 

218 RDRAU -T*2,8 

228 RDRAU T,8 

238 NEXT I 

248 REH HORIZONTAL AXIS 

258 T=<N2-Nl)*0.ei 

268 U»<<X-H1)/I1-INT<<X-M1>/I1>)*I1 

278 HOUE H1,Y 

288 RDRAU U,8 

298 FOR I»U+I11 TO M2 STEP 11 

388 RDRAU 11,8 

318 RDRAU 8,T 

328 RDRAU 8,-T«2 

338 RDRAU 8,T 

348 NEXT I 

358 HOHE 

368 END 
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Lines 

The next example shows that a grid covering the whole window can be drawn by repeated 
useof the AXIS command within a FOR . . . NEXT loop. 

lee PAGE 

110 UIEUPORT 28,118,29,80 
128 MIHDOH 8,148,8,188 
138 FOR I»8 TO 148 STEP 28 
148 AXIS 8,8,1,1 
158 NEXT I 
168 HOHE 
178 END 
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Dots 

For some applications, a grid such as the one shown above clutters the window excessively. 
A grid of dots, shown in the example below, is sometimes more satisfactory. 

led PAGE 

lie uiEUPORT 2e,iie,2e,se 

129 uiNDOM e,i4e,e,iee 

125 AXIS 2e,2e 

130 FOR 1»28 TO 140 STEP 28 

148 FOR J«28 TO 108 STEP 28 

158 HOME I, J 

168 DRAM I, J 

178 NEXT J 

188 NEXT I 

198 HONE 

288 END 
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LOG AXIS 

Linear Example 

Non-linear axis types, appropriate for certain transformations, can be drawn using the tech- 
niques of previous examples. The next example shows a vertical axis with tic marks drawn at 
linear intervals. 

lee PAGE 

lie UIEUPORT 20,118,20,80 

128 HINDOU 1,5,1,18 

138 REH DRAH A}<IS LINES 

148 AXIS 1,8,1,1 

158 REH DRAM UERTICAL AXIS TICS WITH LINEAR INTERNAL 

168 REH TIC HARK LENGTH IS 2'< OF DATA RANGE 

178 T«<5-1)«8.82 

188 FOR 1=1 TO 18 

198 HOME 1,1 

288 DRAU 14T,I 

218 NEXT I 

228 HOHE 

238 END 
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Adapted to Log 

An often used non-linear transformation is log to the base 10. In the exampio below, the tic 
marks on the vertical axis are drawn with a log interval between them. The example below 
is adapted from the example above with only a few modifications. 

188 PAGE 

118 UIEUPORT 28,118,28,88 

128 WINDOW 1,5,LGT<1),LGT(19) 

138 REM ORAM AXIS LINES 

148 AXIS 1 

138 REH DRAW VERTICAL AXIS TICS WITH LOG INTERVAL 

168 REM TIC MARK LENGTH IS 2'/. OF DATA RANGE 

178 T«<5-1)»8.82 

188 FOR 1=1 TO 18 

198 MOVE l,LGT<n 

288 DRAW 1+T,LGT<1) 

218 NEXT I 

228 HOME 

238 END 
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Just as in the previous example, statement 140 draws the axis lines and statements 170 
through 210 draw the tic marks. The only changes required were in the WINDOW, MOVE 
and DRAW commands (statements 120,190, and 200, respectively). In those commands, 
each reference to vertical data has been made the argument of the LGT function. These are 
the only changes required. 



Less Than One Decade 

The previous example's data range runs from 1 to 10, an exact decade. Quite often it is ne- 
cessary to graph data with a range of less than one decade. The simplest way to draw a log 
axis for such data is to expand the graphed data range so that it will span exactly one decade. 
(The data range of the original data remains unchanged.) The example below illustrates this 
technique. 

N1 = Actual vertical data minimum 
N2 = Actual vertical data maximum 
N3 = Adjusted vertical data minimum 
N4 = Adjusted vertical data maximum 

(The output of the program below is identical to the axis presented immediately above. For 
this reason, it is not shown.) 

lee PAGE 

lie uiEUPORT 2e,iie«2e,8e 

in Ki«2ede 

112 H2«8eee 

113 N3»ietINT<LGT(Nl>) 

114 N4=18t(INT<LGT<N2>)+l) 

115 IF N4/N3<»10 THEN 129 

116 PRINT "ERROR: N4 > ie«H3" 

117 END 

128 UINDOH 1,5,LGT<N3>,LGT<N4) 

138 REM DRAM AXIS LINES 

148 AXIS 1,8 

158 REM DRAW VERTICAL AXIS TICS WITH LOG INTERUAL 

168 REM TIC MARK LENGTH IS 2\ OF DATA RANGE 

178 T=<5-1)«8.82 

188 FOR I=N3 TO N4 STEP N3 

198 MOUE l,LGT<n 

288 DRAW 1+T,LGT<I> 

218 NEXT I 

228 HOME 

238 END 
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The only additional statements required are 1 1 1 through 117. Statements 1 1 1 and 1 12 
specify the actual data minimum and maximum. Statements 1 13 and 1 14 adjust the range. 
Statement 1 15 ensures that the data is within one decade. Statements 116 and 1 17 com- 
prise an error exit. 



More Than One Decade 

The example below handles more than one decade with a similar adjustment technique: 

lee PAGE 

lie UIEHPORT 20,110,29,88 
HI Nl«2000 

112 N2-38ee00 

113 N3=ietlNT<LGT<Nl)) 

114 N4el0t<INT<LGT<N2))+l) 
120 UINDOH 1,5,LGT<N3),LGT<N4) 
130 REH DRAM AXIS LIMES 

140 AXIS 1,0 

150 REM DRAH VERTICAL AXIS TICS WITH LOG INTERUAL 

160 REH TIC MARK LENGTH IS Zk OF DATA RANGE 

170 T=<5-1)»0.02 

175 H*LGT<N3) 

180 FOR I*10tH TO 10t<H+l) STEP 10tH 

190 MOUE 1,LGT(I) 

200 DRAH 1+T,LGT<I) 

210 NEXT I 

211 H*H+1 

212 DRAH 5,LGT(10tH) 

213 IF H<LGT<N4) THEN 180 
220 HOME 

230 END 
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This example is identical to the one which preceded it with the following exceptions: 

Statements 1 15 through 1 17 have been removed. They are no longer needed. 

Statements 175 has been added. This sets up the beginning value for the first decade to 
be drawn. 

Statement 180 has been changed. It still draws one decade's tic marks but its beginning 
point, ending point, and increment change during program execution. 

Statement 212 has been added. This is an optional statement. It is really just a "major 
tic" which extends across the entire graphing surface. This adds clarity to the graphed 
results. If statement 212 is removed, a normal tic will remain. 

Statement 213 checks if the axis has been completely drawn, and branches back into 
the loop if it has not. 

Statement 21 1 updates the starting point for the loop which draws the tic marks. 
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POLAR AXIS 

Two Axis Lines 

The polar transformation is also very useful. The simplest polar axis is just 2 crossed lines, 
dividing the graphing window into quadrants. The next example shows how a FOR . . . 
NEXT loop is used to draw these lines. The STEP value in the FOR . . . NEXT loop specifies 
the included angle between adjacent axis lines. 

188 PAGE 

lie SET DEGREES 

128 REM Rl » HAXIMUH RADIUS UALUE 

138 Rl«9 

148 HINDOH -R1,R1,-R1,R1 

158 MIEHPORT 18,98,18,98 

168 REN DRAM AXIS LINES 

178 FOR I>e TO 188 STEP 98 

188 HOME R1*C0S(I),R1*SIN<I) 

198 DRAM RUC0S<I+188),R1»SIN<I + 188) 

288 NEXT I 

218 HOME 

228 END 



In the above example, the defined window and viewport both have the same shape (square). 
If they did not the data would be distorted, causing a circle to be drawn as an ellipse. 
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Two Lines and One Circle 

The next example adds a subroutine which can draw a circle of any given radius. 

188 PAGE 

119 SET DEGREES 

128 REH Rl « HAXINUM RADIUS UALUE 

138 Rl«9 

148 HINDOH -Rl,Rl,-RljRl 

1S8 UIEUPORT 18,98iie>90 

168 REH DRAU AXIS LINES 

178 FOR I«e TO 180 STEP 99 

188 MOUE RUCOS<I),RUSIN<n 

198 DRAH R1«COS<I+188>,R1*SIN<I+130> 

288 NEXT I „ „ 

218 REH DRAH CIRCLE OF RADIUS R 

228 R«Ri 

238 GOSUB 588 

248 HOKE 

258 END 

588 REM SUBROUTINE TO DRAW CIRCLE 

518 MOUE R,0 

528 FOR J«18 TO 366 STEP 10 

530 DRAH R«COS<J>,R*SIN(J> 

548 NEXT J 

558 RETURN 
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In the above example, the straight lines which comprise the circle are just becoming dis- 
cernible. This is due to the STEP size in statement 520 being relatively large. A smaller value 
results in a somewhat more satisfactory-looking circle which takes longer to draw. 



Multiple Lines and Circles 

The example below shows the axis line loop and the circle subroutine being used to make 
additional lines and circles. 

lee PAGE 

lie SET DEGREES 

129 REM Rl » MAXIMUM RADIUS UALUE 

13d Rl>9 

148 UINDOH -R1,R1,-R1,R1 

150 UIEHPORT 16,98,18,98 

168 REM DRAU AXIS LINES 

178 FOR I«8 TO 188 STEP 38 

188 MOUE R1«C0S<I),R1«SIN(I) 

198 ORAM RUC0S<I*188>,R1«SIN<I + 188> 

288 NEXT I 

218 REM DRAU CIRCLE OF RADIUS R 

228 RsRl 

238 GOSUB see 

248 R*Rl*<2/3) 

258 GOSUB 588 

268 R«Rl/3 

278 GOSUB 588 

288 HOME 

298 END 

588 REM SUBROUTINE TO DRAW CIRCLE 

518 MOUE R,8 

528 FOR J- 18 TO 368 STEP 18 

538 DRAU Rl:COS(J>,R«SIN<J> 

548 NEXT J 

550 RETURN 
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In the above example, the STEP value in the FOR . . . NEXT loop (beginning at statement 
170) has been changed from 90 to 30. As a result, the axis lines now occur every 30 degrees. 
The circle subroutine has been used 3 times: with the maximum radius value, with 2/3 
the maximum radius value and with 1/3 the maximum radius value. Some care should be 
exercised when choosing how many axes and circles to place on a polar graph. Too many 
lines and circles lead to a cluttering effect which can obscure data. 



Using RDRAW 

A slightly different approach will avoid this cluttering effect: a polar axis made up of just 
straight lines and tic marks. RDRAW is the most appropriate command for this purpose. 
The next example illustrates this. 
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I IS TIC INTERNAL 

DRAM AXIS LINES 
T IS SIZE OF TIC MARKS 



lee PAGE 

118 SET DEGREES 

129 REM Rl » MAXIHUM RADIUS UALUE 

138 Rl«14 

148 UINDOU -R1,R1,-R1,R1 

158 MIEUPORT 18,98,18,98 

1€8 REH A IS ANGLE BETWEEN AXIS LINES 

178 A=45 

188 REH 

198 1=5 

288 REH 

218 REM 

228 T«R1«8.82 

238 FOR J=A TO 368 STEP A 

248 ROTATE J 

258 NODE 8,8 

268 FOR K=I TO Rl+I STEP I 

278 RDRAM 1,8 

288 RDRAM 8,T 

298 RDRAM e,-T«2 

388 RDRAM 0,T 

318 NEXT K 

328 NEXT J 

338 HOME 

348 END 
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Two nested FOR . . . NEXT loops draw the axes in the above example. The inner loop 
(statements 260 through 310) draws each axis line with tic marks. The outer loop (state- 
ments 230 through 320) determines how many axis lines will be drawn. 

It is desirable for the tic marks to be lined up with the pole of the graph. The easiest way 
to accomplish this is to start each axis line at the pole and draw it outward. This requires 
that the outer FOR . . . NEXT loop (beginning at statement 230) extend through one full 
revolution of 360 degrees rather than through one half revolution of 180 degrees, as in 
the above examples. The inner FOR . . . NEXT loop's terminating value (R1 + I in statement 
260) ensures that the axis lines will extend outward at least as far as the maximum radius, 
R1. If the terminating value of the inner loop is specified (in statement 260) as simply R1, 
the axis lines will extend outward only as far as the last tic inside a radius of R1, an unsatis- 
factory condition. The axis lines should extend at least as far as R1 and preferably farther. 
There is no particular disadvantage in having the axis lines extend too far (other than ex- 
cessive execution time). Any part of an axis line or tic mark which extends outside the de- 
fined window is clipped. This is why half the axis lines in the above example have termi- 
nating tic marks and half do not. 
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INTRODUCTION 

There are three types of character information customarily added to a grapfi: the title, the 
axis label, and the tic mark labels. 

There are literally dozens of ways to title and label a graph. This section discusses the con- 
siderations which influence the addition of characters to a graph and suggests examples of 
how the required tasks can be accomplished. 

Adding characters to a graph in an orderly fashion is a three step process: 

1. Making sure that there is appropriate space on the display for the charjicters. 

2. Positioning the beginning point of the character output so that the characters will 
correctly fill the reserved space. 

3. Printing the characters. 

This entire section describes various ways of performing these three steps. 
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CONSTANT SIZE 

The most significant consideration for labeling graphs on the GS display is that the size 
and orientation of the characters on the display are constant. For example, the size and 
orientation of a letter "A" is not affected by any previously executed commands. In contrast, 
the length and orientation of a line produced by a DRAW command is determined by the 
last executed WINDOW and VIEWPORT commands. The following examples show some of 
the implications of this fact. 

The first example, demonstrates how the size of the viewport does not affect the size of the 
characters. Enter the following statements into the GS: 

108 PAGE 

lie WINDOU e,2,8,2 

128 REH DRAH A BOK AROUND UINDOU 

138 AXIS 

148 AXIS 8,8,2,2 

158 REH PRINT A CHARACTER STRING 

168 REM POSITIONED AT LEFT EDGE OF WINDOW 

178 NOUE 8, 1 

188 PRINT "ABCDEFGHIJKLMNOPQRSTUUWXYZ"; 

198 HOHE 

288 END 

UIEUPORT 48,98,48,98 
RUN 
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Here is the resulting output: 




Now enter the following statements into the GS: 



MIEUPORT 48,56,40,59 
RUN 
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Here is the output that is produced: 




The first viewport is 40 GDU's wide. It contains the printed characters easily. The second 
viewport is only 10 GDU's wide. Although the viewport has become smaller, the characters 
have remained the same size. They no longer fit into the smaller viewport. The window has 
remained unchanged. When the viewport shrinks, the amount of display space occupied by a 
user data unit also shrinks. 

The following four examples illustrate the effect of the WINDOW and VIEWPORT com- 
mands on character output. The initial pair of examples demonstrate the effect of changing 
the window size while holding the viewport size constant. The first example is shown below: 



6-4 



REV A, SEPT 1978 



PLOT 50 GRAPHIC PROGRAMMING 



LABELS 
CONSTANT SIZE 



188 PAGE 

118 MIEHPORT 48,98,48,98 

128 NOME 8, 1 

138 PRINT "FIRST MESSAGE"? 

148 HOME 1,1 

158 PRINT "SECOND MESSAGE"; 

168 HOME 

178 END 

MINDOM 8,2,8,2 
RUN 



FIRST MESSAGE SECOND MESSAGE 



The two character strings above are separated by a comfortable distance. If the width of the 
window is doubled, that is if the viewport's horizontal dimension is made to contain twice 
as many user data units as above, notice what happens. (The result is shown below.) 

UINDOU 8,4,0,4 
RUN 
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FIRST MBBeQSB MESSAGE 



In the above example, the distance between the starting points of the two character strings 
(one user data unit in this case) now becomes less than the length of the first string. As ci 
result, the two character strings now overlap. In any graphing application, this would be 
unacceptable. 

The next two examples show the effect of holding the window size constant and varying 
the viewport. The first example is essentially a return to the previous case, where the strings 
do not overlap. Enter the following statements: 

lie HINDOU 0,2,0,2 
MIEHPORT 40,90,40,90 
RUN 
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FIRST MESSAGE SECOND MESSAGE 



The viewport is reduced to less than half its size in the above example by entering the 
following statements: 

MIEUPORT 48,69,40,66 
RUN 
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In the above example, the same number of user data units now occupy half the display 
space as before. The distance between the starting points of the two character strings, al- 
though being the same distance in user data space, is now half what it was before. So the 
second character string begins before the first one has ended. If the titling and labeling on 
a graph within a certain window and viewport is satisfactory, the same titling and labeling 
might be too sparse, too crowded, or totally unreadable if the window or viewport dimen- 
sions change. 
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TITLING 

Below is a sample function graph with a basic set of axes. 

The program will be gradually expanded as various kinds of titles and labels: are added to it. 

ie« PAGE 
110 INIT 

129 DATA 8»i3e,e,iee 

ne READ gi,U2,lJ3,U4 

140 MIEUPORT U1,U2,U3,U4 

150 UIHDOM 8,PII6,e,30 

1£0 AXIS PI/2,5 

170 HOME 0,15 

180 FOR I-PI/10 TO PI«6 STEP PI/10 

190 DRAU I,SIN(I>XI*15 

200 NEXT I 

210 HOME 

220 EHD 
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Adding a title above this graph (or any graph) is a three step process: 

1 . Reserve the space for the title 

2. Properly position the beginning of the title 

3. Print the title 

Each of these steps can be performed in a variety of ways. 

in the graph shown above, the data and axes totally fill the screen because of the VI EW- 
PORT parameters. Therefore, no characters can be printed outside the specified viewport 
area. However, the top edge of the viewport can be lowered to allow room for the title. The 
statements shown below perform that function when added to the previous example program. 



148 UIEMPORT Ul,U2,U3,U4-3*2.82 



210 REM ADD TITLE TO GRAPH 

228 AM"THIS THE GRAPH'S TITLE" 

239 HOUE 3*PI,30 

248 PRINT "K"; 

258 FOR 1=1 TO LEN(:A$).''2 

268 PRINT "H"j 

278 NEXT I 

288 PRINT A$; 

298 HOHE 

388 END 
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The MOVE command at statement 230 (above) places the graphic point in the middle of the 
horizontal data range and at the top of the vertical data range. The space between this point 
and the top of the allowable viewport (the vertical location specified by var able V4) is three 
character heights. This space was reserved by the VIEWPORT command in statement 140. 
Therefore, a move up of one character height will vertically center a line of characters within 
that reserved space. Statement 240 does just that: moves the graphic point up one character 
space. Centering the title horizontally is just a matter of moving the title's beginning point 
to the left by half the number of characters in the title, much as a title is cantered on a 
typewritten page. The FOR . . . NEXT loop in statements 250 through 270 does this. It 
prints a number of backspace characters (CTRL H) equal to half the numba*^ of characters 
in the title string. The graphic point is now positioned at the correct location for the begin- 
ning of the title string. 
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How much room should be reserved for the title string? It depends mainly on how many 
lines of characters the title will have. The distance between adjacent lines of characters is 
approximately 2.82 GDU's. This is the smallest vertical space that should be reserved for one 
line of characters. In the above example, three lines of space are reserved, one for the title, 
one for a space above the title and one for a space below the title. This is 2.82*3 or about 
8.5 GDU's. This change is implemented in the VI EWPORT command at line 140, above. 
This change lowers the height of the viewport which actually contains the data curve and 
axes, leaving 8.5 GDU's of vertical space between the top of this adjusted viewport and the 
top of the display. This unadjusted top is specified by the variable V4 and is the highest 
allowable location for anything to appear on the screen. 

The title was positioned using a MOVE command and two control characters: CTRL K for 
moving up and CTRL H for moving left. Below is a summary of the characters which move 
the graphic point in increments of one character space. 



Action: 


Character 


Obtainable 


How to 


ASCII 


Moves 


Name 


From Key- 
board With 


Place Into 
A Character 
String 


Value 


To the right 


SPACE 


SPACE BAR 


A$ = " " 


32 


To the left 


BACKSPACE 


CTRLH 


A$ = "i±" 


8 


Down 


LINE FEED 


CTRL J 


A$ = "J." 


10 


Up 


VERTICAL TAB 


CTRL K 


A$ = "K:' 


11 



Three of these characters are entered as control characters: Control H, Control J, and Con- 
trol K. 



This means that in order to enter the character into the GS, the CTRL key is used much 
like the SHI FT key. A control character is entered by pressing the desired character key 
while simultaneously pressing and holding the CTRL key. The "space" character (entered 
with the SPACE BAR) moves the graphic point to the right by 1.79 GDU's, the distance 
which separates adjacent characters. The "backspace" character (which prints on the display 
as 'Ji" or "Control H") moves the graphic point to the left by the same distance. The "line- 
feed" character (which prints on the display as "r meaning "Control J") moves the graphic 
point down by 2.82 GDU's, the distance which separates adjacent lines of characters. The 
"vertical tab" character (which prints on the display as 'J<." or "Control K") moves the 
graphic point up by the same distance. These distances are all GDU's and are not affected by 
the WINDOW, VIEWPORT, or SCALE statements. When manipulating the graphic point in 
this way, it must be remembered that the graphic point is moved to the right whenever a 
non-control character is output. 
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Centering the title within the viewport does not guarantee that the viewport is wide enough 
to contain the title. In the following example, the viewport is narrower than the title. 



12e DATA 38,6d,3e,6e 



THIS THE GRAPH'S TITLE 
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It is easy to add a test which allows the title to be printed only when it will fit. Statement 
225 performs such a test. 



220 A$-"THIS THE GRAPH'S TITLE" 
225 IF 1.79*LEN<A«)>y2-Ul THEN 298 



298 HONE 
308 END 



The test at statement 225 compares the amount of horizontal space the title will occupy 
(1.79 GDU's times the number of characters in A$) with the width of the viewport (V2-V1). 
If the title is wider than the viewport, the title is not printed. 
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AXIS LABELS 

Horizontal Axis Label 

The same three steps are used when labeling an axis: 

1. Reserve space. 

2. Position the beginning of the character string. 

3. Print the string. 



Shown below are the additional statements required to add a label to the horizontal axis. 



123 DATA e, 136,8, lee 



148 UIEHPORT Vl,U2,U3+3*2.82,M4-3*2.82 



298 REM ADD HORIZONTAL AXIS LABEL 

388 H$="H0RI20NTAL AXIS LABEL" 

318 MOUE 3*PI,0 

328 PRIHT »JJ"; 

338 FOR 1=1 TO LEN(H*>/2 

348 PRINT "b"; 

358. NEXT I 

368 PRINT H$! 

378 HOME 

388 END 



PLOT SO GRAPHIC PROGRAMMING 



REV A, SEPT 1978 



6-15 



LABELS 
AXIS LABELS 



THIS THE GRAPH'S TITLE 




HORIZONTAL AXIS LABEL 



The space is reserved in tlie same manner as before except that the bottom of the viewport 
is raised. This is done by forming an adjusted viewport with a bottom 3*2.82 GDU's above 
the previously specified value. In statement 140, 3*2.82 is added to V3, the third argument 
of the viewport statement. The additional statements (290 through 380) are almost identical 
to those added for the title. There is one exception: line 320. Execution of statement 310 
places the graphic point at the middle of the bottom edge of the window. In order to center 
the character line in the provided space, the graphic point must be moved down two lines. 
This is because the graphic point is at the lower left corner of the dot matrix which forms 
the characters. So statement 320 (above) outputs two line feed characters. The other state- 
ments function exactly the same as the corresponding ones which place the graph title on the 
display. 

Vertical Axis Label 

When labeling the vertical axis, being able to print a character string vertically saves much 
space on the display. The following is an example of how this is done. 
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(This program can be entered and run without affecting the program being developed if the 
statement numbers are carefully chosen.) Enter the following statements; 

see PAGE 

818 INIT 

820 OIH A$<l5>,Xf<l) 

838 A$«"THIS IS A TEST" 

848 PRINT A$ 

858 G03UB 1888 

868 C>1938+58 

878 PRINT C 

888 A$=STR<C) 

898 PRINT A$ 

988 GOSUB 1888 

918 END 

1888 FOR I«l TO LEN<A$) 

1818 X$»SEG<A$,M> 

1828 PRINT XtrdJ"? 

1838 NEXT I 

1848 RETURN 

RUN 888 
Here is the output produced: 
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The DIM command at statement 820 is optional. While its use saves memory, its presence 
in the above example is mainly to show that X$ only has to be one character long. The 
SEG command (statement 1010) extracts a character at a time from A$. After each char- 
acter is extracted, it is printed and followed by a backspace (CTRL H) and a line feed 
(CTRL J). This same process can be done easily to numbers by using the STR function. 

The STR function (statement 880) converts the number in C into a character string. It 
can then be placed into A$ and printed vertically, just as the string "THIS IS A TEST" 
was printed vertically. The subroutine which begins at statement 1000 simply prints the 
string A$ but in a vertical orientation. 



A vertical axis label can be added with the following statements: 
DELETE 889,1846 

« 

140 UIEHPORT Ul+3*1.79,U2,M3+3*2.82,y4-3<;2.82 



378 REH ADD UERTICftL AXIS LABEL 

388 U*="UERTICAL AXIS LABEL" 

398 HOUE 8,15 

488 PRINT "dH"; 

418 FOR I«l TO LEN<y*).''2 

428 PRINT "K"J 

438 NEXT I 

448 FOR I«l TO LEN(Ui) 

458 X»-SEG(M$,M) 

468 PRINT X$J"bJ"S 

478 NEXT I 

488 HONE 

498 END 
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HORIZONTAL AXIS LABEL 
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TIC MARK LABELS 

Labeling individual tic marks, though not difficult, requires more programming effort and 
GS memory space than is appropriate for many applications. It is sometimes preferable just 
to print the parameters of the AXIS command somewhere within the viewport. The most 
suitable location for this information is usually just above the lower edge of the viewport, 
either to the right or left of the horizontal axis label. If only one line is being printed, the 
space reserve specified at the third parameter of the VIEWPORT statement (line 140 above) 
need not be changed. However, in this next example, three lines are printed for the AXIS 
and tic information. So five lines of space are reserved. 



140 UIEMPORT yi+3*1.79,U2,U3+5«2.82,U4-3*2.82 



48e REM PRINT TIC t< AXIS DATA 

49e MOUE 8,8 

588 PRINT "JJAXIS CROSSING = 8,0"! 

518 nOUE 8,0 

528 PRINT "JJJX TIC INTERUAL = PI.-2"5 

538 HOME 8,8 

548 PRINT "JJJJY TIC INTERUAL « 5"; 

558 HOHE 

568 END 
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A technique which makes the graphed data easier to comprehend is to place a value cor- 
responding to each tic adjacent to the actual tic mark itself. Below is an example of this 
method, including a list of all statements that were changed or added to the example above. 



148 UIEMPORT Ul+8»1. 79, U2-4«l. 79,^3+4*2. 82,^4-3*2. 82 



328 PRINT "JJJ"? 



408 PRINT "titJUbtJtJb"; 
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480 REH LABEL HORIZ. AXIS TIC MARKS 

499 FOR I«0 TO 6*PI STEP PI 

588 nOUE 1,8 

518 PRINT •BbJ"5l/Pl5"*PI"; 

528 NEXT I 

538 REH LABEL UERT. AXIS TIC MARKS 

548 FOR I«8 TO 30 STEP 5 

558 HOUE 0,1 

568 PRINT "HHb"n5 

578 NEXT I 

588 HOHE 

598 END 




The VIEWPORT statement (line 140) is changed because more space is required for the 
labels. Eight character widths are reserved to the left (V1+8*1 .79). This is larger than before 
because space must be reserved for more characters. Four character widths are reserved to 
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the right (V2-4*1.79) to make room for the last tic label on the end of the horizontal axis. 
Five character heights are reserved below the graph. More space is needed here mainly to 
make the labels easier to read. No additional room has been reserved above the graph in this 
example because nothing else has been added to that area. 

Because of these changed space allocations, the initial positioning of both liie horizontal 
axis label (statement 320) and the vertical axis label (statement 400) are also changed. If 
they are not changed, the axis labels will conflict with the tic labels printed in statements 
480 through 590. 

Statements 490 through 520 label the horizontal axis tics. Inherent in the VIEWPORT com- 
mand at line 140 are assumptions about the amount of space occupied by t^ese tic labels. 
One character height of space below the axis is reserved, along with four cteracter widths 
to the right of the last tic mark on the axis. If this last space is not reserved, part of the last 
label is printed outside the viewport, an unacceptable situation. An assumption about the 
width of the labels is implied in two statements: in the STEP size of the FOR command at 
statement 490 (if this step size is too small, the labels will be printed on top of each other), 
and in the number of backspaces printed at statement 510. The number l/Pl will always be 
an integer in this situation because of the FOR . . . NEXT loop's beginning value and step 
size. 

The "*p|" in statement 510 (above) shows that the addition of characters to each tic label 
requires only the presence of the desired character string in the PRINT statement. The com- 
bination of a one digit integer and the "*p|" js always four characters long. Hence the two 
backspace characters (CTRL H) in statement 510. 

Unless special considerations are made in the program, it must be assumed that each tic 
label is made up of no more than a certain number of characters. Only after this assumption 
is made can the step size in the FOR statement (statement 490 in this example) and the 
label position (statement 510 in this example) be set up. The step size in the FOR state- 
ment also determines the frequency of the tic labels. If the tic mark labels are too close 
together, they become more difficult to read. 

Most of the horizontal axis tic label description applies with only slight changes to the 
vertical axis tic labels. The major difference is that the assumed maximum for the number 
of characters allowable in a vertical axis tic label has a more direct effect oii the STEP size 
in the FOR statement (statement 540). The first parameter of the VIEWPORT at line 140 
was changed to V1-t-8*1.79 (eight character widths reserved). The assumed maximum 
number of characters for the label is three. There are several ways to ensure that the number 
of characters in a given label will not exceed the assumed maximum. These are described 
later in this section. 
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RESERVING SPACE 

As was stated earlier in this section, the three steps required for adding characters to a graph 
are: 

1. Reserving space 

2. Positioning 

3. Printing 

The first of these three, space reservation, is now discussed. 

The technique used so far in all this section's examples is to adjust the parameters of the 
viewport command by the appropriate number of GDU's in each direction. This is the best 
general method because the amount of space reserved is always known exactly. Another ap- 
proach is to alter the VIEWPORT by specified percentages of the VIEWPORT height and 
width. The example below decreases the size of the viewport so that the adjusted rectangle 
is smaller than the unadjusted one. 

Unadjusted: 

UIEMPORT Mi,U2,U3,U4 

Percentage Adjustment: 

UIEHPORT Ul+<U2-Vl)«0.1,U2-(U2-Ul)*0.1,U3+(U4-U3)*0.1,U4-(U4-t.i3>*0.:l 

Advantages: Space reservation changes with viewport size; a more pleasant appearance 
results. 

Disadvantages: The exact quantity of space reserved is unknown. 

Too little space is reserved with small viewports, too much with large ones. 

Both of these techniques have the characteristic of adjusting the size of the clipping rectangle, 
that area outside which no graphic output will appear. 

The size of the window can also be adjusted to make room for labels. This technique is not 
appropriate for the above example. However, it is described and used in the next section, 
where its use is very appropriate. 
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POSITIONING 

The second required process is to position labels within the allotted space. After the graphic 
point is placed at the location to be labeled, it nnust then be moved a certain number of 
character spaces to ensure that the printed characters are positioned properly. The following 
situations are among those which require this capability: centering a graph litle within the 
allotted space, properly positioning a tic mark label, and centering a characier over a point 
on the display. There are three ways this can be done. 

The simplest way is to use the control characters described in Sections 1 ami 6: SPACE, 
BACKSPACE (CTRL H), LINE FEED (CTRL J), and VERTICAL TAB (CTRL K). All ' 
examples so far in this section have used this technique. The following prog^-am fragment 
shows its use: 



398 REH TO MOUE ONE CHARACTER SPACE HEIGHT DOWN 

318 PRINT "J"; 

328 REM TO HOME ONE CHARACTER SPACE HEIGHT UP 

338 PRINT "K"' 

348 REM TO MOME ONE CHARACTER SPACE WIDTH TO THE llGHT 

358 PRINT * " t 

368 REN TO MOUE ONE CHARACTER SPACE WIDTH TO THE LEFT 

378 PRINT "H"? 



Advantages: Simple to use. 

Doesn't require keeping track of WINDOW and VIEWPORT parameters. 
It is a true relative move in character distance incremerts. 

Disadvantages: Can only move in increments of one entire character ht:ight or width 
(is therefore too imprecise for some situations). 



The second way is to totally rescale the graph at the point desired, use RI\/IC)VE to position 
the graphic point, and re-window to restore the original mapping situation. The example 
below moves 1 .3 character widths to the left and .2 character heights below the point X,Y. 



388 UINDOU W1,W2,W3,U4 

318 MOUE X,Y 

328 SCALE 1,1 

338 RMOUE -1.3*1.79,-0.21:2.82 

348 PRINT "LABEL"; 

358 UINDOU M1,W2,W3,W4 
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In the preceding program fragment, the SCALE command at statement 320 establishes a one- 
to-one correspondence between user data units and GDU's. It is also possible to establish 
a one-to-one correspondence between user data units and character spaces. The number of 
character widths and heights to be moved can then be used directly as arguments of the 
RMOVE command (statement 330). The program fragment below demonstrates this technique 
showing the appropriate arguments to use in the SCALE command. 



388 UimOH Ul,tJ2,U3,U4 
310 MOME X,Y 
328 SCALE 1/1.79,1/2.82 
339 RMOUE -1.3,-8.2 
348 PRINT "LABEL"} 
358 UINDOW U1,U2,I43,H4 



Advantages: Allows movement in fractional character increments. 

Simple to use. 

Disadvantages: The previously defined window must be restored after this technique 
is used (as in statement 350, above). 

The third way is to use the window and viewport parameters to compute the number of 
horizontal and vertical user data units required for a movement on the display of 1 GDU. 
Below is an example illustrating this technique. 



388 MINDOH M1,H2.I>I3,U4 

318 MIEWPORT in,V2,U3,tM 

328 REH SI IS NUMBER OF HORIZONTAL USER DATA UNITS PER GDU 

338 S1=<W2-W1)/<U2-U1> 

348 REM S2 IS NUMBER OF VERTICAL USER DATA UNITS PER GDU 

358 S2=(H4-W3V(U4-U3) 

368 REM TO THE LEFT 2.4 CHARACTER WIDTHS AND 

378 REM DOWN 1.5 CHARACTER HEIGHTS 

388 RMOUE -2. 4*S1*1. 79, -1.5*52*2.82 



Advantages: Allows movement of fractional character increments. 

Disadvantages: Can be cumbersone if window or viewport specifications are intricate. 
Requires keeping track of WINDOW and VIEWPORT parameters. 
Can require two extra variables. 
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PRINTING 

The third required process is to actually print the label. The most useful enhancement for 
printing is the guarantee that a number's printed image on the screen will not exceed a cer- 
tain number of characters. There are several ways to provide this guarantee. One way is to 
use the INTeger function to round the number to a specified quantity of significant digits. 
Another method is to utilize PRINT .. . USING, documented in the Plot 50 Introduction 
to Programming in BASIC. These techniques can ensure that numbers of excessive length 
are never printed. An example which utilizes the PRINT . . . USING commajid is described 
in the next section (Section 7). 
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"NEAT" TIC INTERVALS 

Manually calculating the appropriate tic intervals for a given data range can be tedious. A 
preferable situation is to have a program do it. Below are two example graphs with "neat" 
tic intervals on the horizontal X axis calculated by the Graphic System. 



HORIZONTAL MIN «. MAX « -.0623,. 0068 



-e.eez 



0.002 0.984 e.0eg 
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HORIZONTAL niN «< NAX « 1234567,9876543 




The program used is listed below. 

lee REH SAMPLE LABELED "NEAT" TICS FOR HORIZONTAL AXIS 

Ue PAGE 

120 DATA 10jl2e, 19,90,-130, 130, -25, 75, 6 

130 RESTORE 

140 READ Ul,U2,U3,U4,Nl,M2,U3.t44,N 

150 UIEHPORT Ul,U2,U3,y4 

150 HONE 

170 PRINT "HORIZONTAL MIN «, MAX = "; 

180 INPUT H1,U2 

190 REM CALCULATE "NEAT" INTERUAL & EXPANDED DATA LIMITS 

200 GOSUB 2000 

210 UINDOM M1,M2,U3,M4 

220 AXIS 0,0,M1,U3 

230 AXIS 0,0,n2,U4 

240 AXIS S,0 

250 GOSUB 3000 

260 END 
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2886 REM COMPUTE "NEAT" TIC INTERUAL FOR HORIZONTAL AXIS 
2818 REM R=»RAW" TIC INTERNAL 
2820 R=(M2-W1)/N 

ll^t REM S;LARGEST INTEGER POWER OF TEN STILL SMALLER THAN RAW INTERNAL 

2840 S=10tINT(LGT<R)) 

2058 REM T= RAM INTERUAL / NEXT SMALLEST POWER OF TEN 

2860 T=R/S 

2870 IF T>2 THEN 2118 

2880 IF T«l THEN 2150 

2890 S=2»S 

2100 GO TO 2150 

2110 IF T>5 THEN 2140 

2120 S=5*S 

2138 GO TO 2150 

2140 Sb18»S 

2150 REM S»"NEAT" TIC INTERUAL 

2160 REM ADJUST DATA MINIMUM 

2170 M1«INT<H1/S> 

2180 Ml«S*(Ml+2> 

2190 IF MKWl THEN 2220 

2200 M1=M1-S 

2218 GO TO 2190 

2220 REM FOUND ADJUSTED MINIMUM 

2230 REM ADJUST DATA MAXIMUM 

2240 M2=INT(H2/S> 

2250 M2=S«(M2-2> 

2260 IF W2<M2 THEN 2290 

2270 M2=M2+S 

2280 GO TO 2260 

2290 REM FOUND ADJUSTED MAXIMUM 

2380 RETURN 

Itl^ Si" LABELING ROUTINE FOR HORIZONTAL AXIS 

^880 S7=M1 

3018 S8=W3 

3820 Sl=M2-S/2 

3030 S7=S7+S 

3848 IF S7>S1 THEN 3128 

3858 MOUE S7,S8 

3860 A*-STR<S7> 

3870 FOR Q=l TO LEN(A$)/2 

3080 PRINT "H"j 

3898 NEXT Q 

3188 PRINT S7 

3118 GO TO 3038 

3128 RETURN 



A subroutine beginning at line 2000 calculates an appropriate tic interval for the horizontal 
axis based on the three parameters: the horizontal data minimum (assigned to variable W1), 
the horizontal data maximum (assigned to W2), and the maximum number of tic marks de- 
sired (assigned to N). The tic interval calculated is a multiple of 1, 2, or 5. Tii: intervals 
calculated in this manner are referred to as "neat". N is initialized to 6 in the READ state- 
ment at line 140. Lines 2020 through 2150 calculate a tic interval which will result in no 
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more than N tic intervals being drawn. This interval is passed back to the main program in 
variable S. Lines 2160 through 2220 adjust the data minimum downward so that the new 
data minimum will be an integer multiple of the tic interval. This adjusted data minimum is 
passed back in variable Ml leaving the original data minimum, W1, undisturbed. Similarly, 
lines 2230 through 2290 adjust the data maximum upward, passing the new data maximum 
back in variable M2. 

After the tic interval, adjusted data maximum and adjusted data minimum have been deter- 
mined, the window can be defined with the WINDOW command (line 210). Note that the 
arguments for the horizontal range of the WINDOW command are the adjusted data mini- 
mum (M1) and the maximum (M2), not the original data minimum (W1) and maximum 
(W2). The two AXIS statements at lines 220 and 230 simply draw a box around the window 
to show that no tic labels extend outside it. The AXIS statement at line 240 draws the axis 
with the "neat" tic interval S. Then the subroutine beginning at line 3000 is called to label 
the horizontal axis. 



This routine to label the tics requires the following information: the adjusted data minimum 
(Ml) to know where to start; the adjusted data maximum (M2) to know where to stop; the 
tic interval (S); and the vertical data minimum (W3) to know where to position the labels 
vertically. All other variables used are scratch variables. 

The subroutine positions the labels with the same technique that was used at the end of the 
previous section. Line 3050 places the graphic point directly below the tic to be labeled. The 
value to be printed is converted to a character string using the STR function. Then a FOR. . . 
NEXT loop (statements 3070 through 3090) outputs a number of backspaces equivalent to 
half the number of characters in the label to be printed. If a situation arises where the labels 
are too close together and begin to overlap, changing N to a smaller number will cause fewer 
labels to be printed, reducing the chance of overlap. In the above program, space for the 
labels is reserved by expanding the window. The entire program requires no access to the 
viewport parameters. If the viewport is specified from the keyboard just prior to program 
execution, there is no need for any VIEWPORT command (such as the one at line 140) in 
the program at all. 

For certain applications, tic labels with a normalized scientific notation are desirable. The 
example below shows such labels. 
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HORIZONTAL MIN J, MAX = 89E7,201E7 



i.ee 



1^2L 



1.40 



1.60 



1.86 



2.ea E-t-9 



The program which generated these labels is identical with the previous exsiriple program, 
listed above, with the exception of the labeling subroutine beginning at stat;;ment 3000. It 
is listed below. 

2990 REM LABELING ROUTINE FOR HORIZONTAL AXIS 

3896 S7»M1 

3616 Sd«M3 

3826 S3»ABS<M1+S) MAX ABS<M2-S) 

3636 S3«INT<LGT<S3)+1.0E-8) 

3846 S2«10t-S3 

3858 Sl«M2-S/2 

3666 S7«S?+S 

3070 IF 37>S1 THEN 3126 

3086 NOUE S7,S8 

3896 PRINT "bb"; 

3106 PRINT USING "-D. 2D,S" :S7*S2 

3116 GO TO 3860 

3126 IF S3=0 THEN 3168 

3130 S7=S1 

3146 MOUE S7,S8 

3156 PRINT USING "2A, +FD,S'': " E";S3 

3166 RETURN 
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The required input variables are the same (Ml, M2, W3, S). But the way they are handled is 
slightly different. Statements 3020 through 3040 calculate a normalizing factor, used when 
the tic values are printed (statement 3100) and to determine if an exponent needs to be 
printed (statement 3120 through 3150). The example program above prints the tic labels 
with a PRINT USING command. This guarantees that the tic labels never exceed a certain 
number of characters in length (4 + 1 space in this example). Therefore, the labels can be 
positioned properly with a constant number of backspaces. Statement 3090, which outputs 
two backspaces, replaces a FOR . . . NEXT loop. In addition, the task of reserving space for 
the labels is simplified by knowing for certain how many characters comprise each label. 

The next example extends the techniques of the above example to the general case of 
labeling tics on both the horizontal and vertical axes. 



HINDOH PARAMETERS « -150, 280, -.857, .62 

NUMBER OF TICS - HORIZONTAL «< UERTICAL AXIS « 5,7 



E-2 



2.( 



9.09 



-2.00 



•4.00 



•IJ90 



0.00 



1.00 



2.00 E-^2 
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REM LABELED "NEAT" TICS - GENERAL CASE 
lid PAGE 

120 PRINT "WINDOW PARAMETERS = "5 
130 INPUT H1,W2,W3,W4 

140 PRINT "NUMBER OF TICS - HORIZONTAL & UERTICAL AXIS = "; 
150 INPUT N1.N2 
160 UIEMPORT 10,120,10,90 
170 DIM P<8) 
180 P<1)=W1 
190 P<2>=W2 
280 P(3)=N1 
210 P<:5)=W3 
220 P<6>=W4 
230 P<7)=N2 

240 REM CALCULATE NEW LIMITS AND INTERNALS 
250 P5=3 
260 GOSUB 2300 
270 P5=7 
280 GOSUB 2000 

290 WINDOW P(1),P<2>,P(5>,P<6) 
300 AXIS P(3),P(:7),P<1>+P(3),P<5)+P<7) 
310 REM LABEL THEM 
320 P5*4 
330 A$="BUH" 
340 GOSUB 3000 
350 P5=8 
360 tt$~ " " 
370 GOSUB 3000 
380 HOME 
390 END 



2000 REM P<P5) = MINIMUM NO. OF TICS 

2010 Pl = <P<P5-l>-P<P5-2)).-'P(P5) 

2020 P2=10tINT<LGT<Pl>> 

2030 P1«P1/P2 

2040 IF Pl>2 THEN 2080 

2050 IF Pl=l THEN 2120 

2060 P2=2*P2 

2070 GO TO 2120 

2080 IF Pl>5 THEN 2110 

2090 P2=5*P2 

2100 GO TO 2120 

2110 P2=10*P2 

2120 REM ADJUST DATA MIN 

2138 Pi=INT(P(P5-2)/P2) 

2140 P3=P2*(Pl+2> 

2150 IF P3<P(P5-2> THEN 2188 

2160 P3=P3-P2 

2170 GO TO 2150 

2180 P(P5-2)=P3 

2190 REM ADJUST DATA MAX 

2200 P1=INT(P<P5-1)/P2> 

2210 P3=P2*<Pl-2) 

2220 IF P<P5-1)<P3 THEN 2258 

2230 P3=P3+P2 

2240 GO TO 2220 

2250 P<P5-1)=P3 

2260 REM P<P5)=ADJUSTED TIC INTERNAL 

2270 P<P5>='P2 

2280 RETURN 
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3063 REH LABEL AXIS 

3@ie P4=P(P5-1> 

3829 P(4)-P<1) 

3838 P(S'^-Pk5) 

3848 P3=ABS(P(P5-3)+P4) MAX ABS<P<P5-2>-P4) 

3858 P3=INT(LGT<P3)+1.8E-8> 

3868 P2=18t-P3 

3878 Pl=P<P5-2)-P4/2 

3888 P(P5)«P(P5>+P4 

3898 IF PfP5>>Pl THEN 3148 

3188 MOUE P<4),P<8> 

3118 PRINT A$; 

3128 PRINT USING "-D.2D, S":P(P5>*P2 

3139 GO TO 3888 

3148 IF P3=0 THEN 3188 

3158 P(P5)=P1 

3168 MOVE P<4),P<8) 

3178 PRINT USING "2A,+FD,S":" E";P3 

3188 RETURN 



Neither of the routines in the program listed above requires any knowledge of what the view- 
port has been set to. The VIEWPORT statement at line 160 could be deleted and the view- 
port set from the keyboard just prior to program execution. (An I NIT command anywhere 
in the program would restore the viewport parameters to the default, full size, values.) 
Lines 120 through 150 cause the data limits and the desired number of tics to be input from 
the keyboard. Statements 170 through 230 set up array P, which is used to pass values to and 
from the routines. (The values assigned to variables W1 , W2, W3, W4, N 1 , and N2 remain un- 
changed after they are input.) Array P is set up to allow a subroutine to be usable for both 
the horizontal and vertical axes. The subroutines listed in the example above perform func- 
tions identical to those in the first two examples of this section. They have been changed 
only to allow them to be used on both the horizontal and vertical axes. 

The routine beginning at line 2000 affects only the variables P(P5), P(P5-1 ), and P(P5-2). 
All other variables in the routine are used for scratch purposes. (The values they contain are 
of use only while the subroutine at statement 2000 is being executed.) When the routine at 
statement 2000 is called with P5 equal to 3 (as it is at statement 260), the routine affects 
only the elements P(1), P(2), and P(3) in array P. When the routine is called with P5 equal 
to 7 (as it is at statement 280), the routine affects only P(5), P(6), and P(7). When entering 
the routine with P5 equal to 3, meaning that all data values pertain to the horizontal axis, 
the subroutine uses P(1) as the original data minimum, P(2) as the original data maximum 
and P(3) as the specified number of tic marks. The routine uses these same locations to re- 
turn the values it calculates. It returns the adjusted data minimum in P(1 ), the adjusted data 
maximum in P(2), and the "neat" tic interval in P(3). Similady, when called with P5 = 7, 
the routine returns the adjusted data minimum P(5), the adjusted data maximum in P(6), 
and the "neat" interval in P(7). These values are then used directly in the WINDOW com- 
mand in line 290 and the AXIS command in statement 300. 
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The routine beginning at line 3000 lias data passed to it in a similar manner. There are, how- 
ever, two significant changes. The labeling routine at 3000 prints A$ (statement 3110) be- 
fore printing each label (statement 3120). A$ contains positioning characteis as needed: 
three backspaces for horizontal axis labels, no characters at all for vertical axis labels. The 
other difference is that P(4) and P(8) are used to position each label, with P(4) being the 
horizontal position and P(8) being the vertical position. The variable P5 detJirmines which 
of them is updated in the loop formed by statements 3080 through 3130. This scheme, which 
may appear complex, allows very efficient use of memory space for both data and program 
statements. 

The next example (shown below) is identical to the above example with the following 
exceptions: lines 140 through 160, line 200, and line 230. 



WINDOW PARAMETERS » -83, 122, -.833, .08 
UIEWPORT PARAMETERS « 10,120,19,80 








E-2 










6.00 


• 








4.00 


- 








2.00 


- 








0.00, , 










-2.00 


■ 








-0.50 0. 


00 


0.50 


E+2 





PLOT 50 GRAPHIC PROGRAMMING 



REV A, SEPT 1978 



7-9 



ENHANCEMENTS 
"NEAT" TIC INTERVALS 



H • 



lee REH LABELED "NEftT" TICS - GENERAL CASE 

110 PAGE 

120 PRINT "HINOOW PARAMETERS = 

130 INPUT M1,U2,U3,U4 

140 PRINT "UIEWPORT PARAMETERS « "; 

150 INPUT U1,M2,V3,U4 

160 UIEHPORT U1+6*1.8,U2,U3+3*2.8,U4 

170 DIM P<8> 

180 P(1>«U1 

190 P(2)«H2 

200 P<3)«INT<<U2-(U1+6*1.8)>/(3*1.8)> MAX I 

210 P(5)=H3 

220 P<:6)«W4 

230 P(7>«INT<<U4-<M3+3*2.8))/<3*2.8>> MAX 1 

240 REM CALCULATE NEW LIMITS AND INTERUALS 

250 P5=3 

260 GOSUB 2000 

270 P5=7 

280 GOSUB 2000 

290 WINDOW P<1),P<2),P(5),P<:6> 

300 REM AXI P(3),P<7),P(1HP<3),P(5>+P<7> 

310 AXIS P(3),P(7) 

320 REM LABEL THEM 

330 P5=4 

340 A$>*iJUUJJ'' 

350 GOSUB 3000 

360 P5=8 

370 A$-*tJUUbti" 

380 GOSUB 3000 

390 HOME 

400 END 



These changes allow the program to determine the number of tic labels which will fit into 
the specified viewport. The number of desired tics on each axis does not have to be entered. 
After the viewport parameters are entered in line 150, the viewport can be set up. As in 
examples in Section 6, the effective viewport size is reduced to make room for the labels. 
The viewport's horizontal minimum is increased by 6 character widths. 



160 VIEWPORT M1+6*1.8,U2,U3+3*2.8,U4 



This adjustment is based on the assumption that the vertical axis labels will be no wider 
than 5 characters. The viewport's vertical minimum is increased by 3 character heights, 

160 UIEHPORT Ul+6*l.8,l.J2,U3+3*2.8,U4 



This adjustment is based on the assumption that the horizontal axis labels will occupy no 
more than one character line. 
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Line 200 determines tlie number of horizontal axis labels which will comfortably fit within 
the specified viewport width. It does this by dividing the effective viewport width 
[ (V2 - (V1+6*1.8)) ] by the horizontal space taken up by 8 characters [8*1.8] .The 
figure 8 characters is used to ensure that the labels will not be too close togt-ther, causing a 
cluttered appearance. The MAX 1 in lines 200 and 230 prevents the number of labels re- 
quested from being less than 1, an event which the algorithm in the routine at 2000 is not 
prepared to handle. 

Line 230 performs a similar task for the vertical axis labels. However, in this line, the effective 
viewport height is divided by 3 character heights to determine the appropriate number of 
labels. If the complete program is run with a variety of viewport sizes specif ed, the smaller 
viewports will produce fewer labels as appropriate. 
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DASHED LINES 

Below is a sample graph of dashed lines. 



XI, Yl . -158,8 
X2,Y2 ■ 158,-58 



-< •- 



I I 
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The point XI ,Y1 is located by tiiie "1 " to the left of the window. The point X2,Y2 is 
located by the "2" to the right of the window. The routine at statement 101)0 draws a 
dashed line from XI, Y1 to-X2,Y2, subject to the appropriate clipping performed by the 
window and viewport. 

198 REH DASHED LINE PROGRAM - GENERAL CASE 

119 PAGE 

120 RESTORE 

133 DATA 33, 130, 10,80,-186, 100,-180,100 

140 READ U1,U2,U3,U4,W1,H2,W3,W4 

150 MIEHPORT yi,U2,U3,M4 

168 UINDOH M1,U2,U3,U4 

178 REM DRAW A DASHED LINE FROM XI, Yl TO X2,Y2 

180 PRINT "XI, Yl » »} 

190 INPUT XI, Yl 

200 PRINT "X2,Y2 = "; 

210 INPUT X2,Y2 

220 AXIS 25 « ''5 

230 REM DRAW BOX AROUND UIEWPORT 

240 AXIS O,0,M1,W3 

250 AXIS 0,0,W2,W4 

260 MOUE X2,Y2 

270 PRINT "2tl"; 

280 MOUE X1,Y1 

290 PRINT "iH«5 

308 GOSUB 1000 

318 END 

1888 REM SI IS NUMBER OF HORIZONTAL USER DATA UNITS PER GDU 

1818 S1«<W2-W1)/<U2-U1) 

1828 REM 32 IS NUMBER OF UERTICAL USER DATA UNITS PER GDU 

1838 S2»<W4-W3).-'<U4-M3) 

1848 REM FIND HORIZONTAL DISTANCE IN GDU's 

1850 D1=<X2-X1)/S1 

1960 REM FIND UERTICAL DISTANCE IN GDU's 

1070 D2«<Y2-Y1)/S2 

1888 REM D IS DISTANCE BETWEEN POINTS IN GDU's 

1890 D«SQR<Dlt2+D2t2) 

liee IF D«8 THEN 1348 

llie REM DESIRED DASH LENGTH IN GDU's IS L 

1128 L>1 

1130 REM FIND HORIZONTAL COMPONENT OF DASH IN USER UNITS 

1140 U1=L*<D1.''D)*S1 

1150 REM FIND UERTICAL COMPONENT OF DASH IN USER UNIT? 

1160 U2»L*<D2.'D>*S2 

1170 HOME XI, Yl 

1180 REM CURRENT HORIZONTAL POINT IS H 

1198 H>=X1 

1298 REM CURRENT UERTICAL POINT IS U 

1218 U=Y1 

1228 REM CLEAR FLAG 

1238 F=0 

1240 REM BEGIN LOOP TO DRAW DASHED LINE 

1250 GOSUB 1350 

1260 IF F=l THEN 1339 

1270 DRAW H,U 

1280 GOSUB 1350 

1290 IF F=l THEN 1330 
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1388 MOUE H.U 

1318 GO TO 1250 

1328 REM DONE 

1338 DRAW X2,Y2 

1348 RETURN 

1358 REM SUBROUTINE TO CHECK IF DONE 

1368 H^H+Ul 

1378 U=U+U2 

1388 IF ABS<H-X1)>ABS(X2-X1> THEN 1418 

1398 IF ABS(U-Yn>ABS(Y2-Yl> THEN 1418 

1488 RETURN 

1418 F=l 

1428 RETURN 

In order to draw the dashed line, the routine requires the following information: the view- 
port parameters (in this example VI, V2, V3, V4), the window parameters (in this example 
W1,W2,W3,W4), the desired dash length in GDU's (L in this example), and, of course, the 
beginning point (XI, Y2) and ending point (X2,Y2) of the dashed line. The subroutine is log- 
ically divided into two sections. The first section (from statements 1000 through 1 160 in the 
above listing) uses the dash length, window and viewport information to calculate the hori- 
zontal and vertical components of the dash in user units. Once these two components are 
known, the dashed line can be drawn in user space, which makes the line subject to clipping. 

This is very desirable, as the sample dashed line graph (above) shows. The second logical por- 
tion of the routine, beginning at statement 1 170, is a loop which actually draws the dashed 
line. Since both the move and draw segments of the line need to be checked to see if the 
ending point of the line has been reached, this checking function has been placed in a sub- 
routine beginning at line 1350. The variable F is a flag to tell the main loop in the routine if 
the ending point has been reached. 
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GRAPHIC DATA EDITING 

The Graphic System can be used to edit data graphically. The program listed below shows 
a method for performing this task. 

3 GO TO lee 

4 RMOME 8,P2 

5 RETURN 

8 RHOUE -PI, 8 

9 RETURN 

12 RHOME Pl,e 

13 RETURN 

16 GO TO 269 

29 REH BEGIN EDITING 

21 GOSUB 1898 

22 PRINT 632,24: "I"} 

23 GO TO 22 

24 RHOUE e,-P2 

25 RETURN 

36 REH FIND POINT 

37 GOSUB 2088 

38 RETURN 

48 REH CHANGE POINT 

41 GOSUB 3888 

42 RETURN 

44 RHOUE 8,18*P2 

45 RETURN 

48 RHOME -ie»Pl,8 

49 RETURN 

52 RHOUE 18»P1,8 

53 RETURN 

64 RHOUE 0,-18»P2 

65 RETURN 

97 REH USER DEFINABLE KEYS: 

98 REH UP LEFT RIGHT REGRAPH EDIT 

99 REH DOUH FIND CHANGE 

188 INIT 

lie SET KEY 

128 REM GENERATE SAMPLE DATA 

138 Din A(58) 

149 I11>1.8E*388 

158 M2»-1.8E+3e8 

168 A(l)>18 

178 FOR I«2 TO 58 

188 A(I)«5*RND<-l)+5+I*1.5 

199 IF I048 THEN 218 

288 A(4e)«A<39)/2 
218 M1=M1 MIN A<I) 
228 H2=M2 MAX A(I) 
239 NEXT I 

249 REM GRAPH DATA 
258 PAGE 

260 UIEWPORT 19,125,10,95 
279 UINDOU 9,51,9,109 

289 AXIS 5,19 

299 C 1*51. ■'120* 1.55/2 
390 C2=199/90*1.88/2 

319 FOR 1=1 TO 50 

320 HOME I-C1,A<I)-C2 
338 PRINT "+«"; 

340 NEXT I 
358 HOME 
368 END 

PLOT 50 GRAPHIC PROGRAMMING REV A, SEPT 1 978 7-15 



ENHANCEMENTS 
GRAPHIC DATA EDITING 



leae ren begin editing 

leie REM CALCULATE .5X OF WINDOW IN EACH DIRECTION 

1826 Pl<:58«e.e85 

1038 P2>'ie8*d.8d5 

1848 REM INITIAL PLACEMENT OF POINTER 

1858 GIN G1,G2 

1668 NOME G1,G2 

1878 REM CHANGE FONT 

1880 PRINT e32,18:5 

1890 RETURN 

2080 REM FIND POINT 

2010 GIN G1,G2 

2028 D-1 OE-^300 

2030 rem' search DATA POINTS FOR CLOSEST FIT 

2040 FOR 1=1 TO 50 

2050 Dl=SQR<<Gl-I)t2+<G2-A(I))t2) 

2060 IF D1>D THEN 2080 

2070 D=D1 

2080 NEXT I 

2090 REM TEST TO INSURE POINT REALLY FOUND 

2100 J=INT<Gl+0.5) 

2118 IF J<1 OR J>58 THEN 2158 

2128 IF ABS<J-Gn>2*Pl OR ABS(G2-A<J))>2*P2 THEN 2150 

2138 REM POINT FOUND 

2140 RETURN 

2150 REM POINT NOT FOUND, RESTORE DEFAULT FONT 

2168 PRINT 832,18:8 

2178 END 

3800 REM CHANGE POINT 

3010 REM RESTORE FONT 

3020 PRINT §32,18:0 

3030 HOME 

3040 PRINT "CHANGE AC'JJ?")" 

3050 PRINT "FROM '';A(J? 

3060 PRINT " TO "S 

3070 INPUT AC J) 

3080 END 



Typing RUN causes lines 100 through 360 to be executed. Lines 140 through 230 fill array 
A with sample data. The minimum and maximum values are placed in Ml and M2, respec- 
tively. Lines 190 and 200 cause an obviously out of line data point to be placed in A(40). 
Lines 250 through 340 graph the data in array A, marking the location of each data point 
with a "+". In order to be centered over the data point, each "+" is offset by a vertical 
distance equal to one half a character height and a horizontal distance equal to one half a 
character width. Line 290 calculates the distance, in horizontal user units, equal to one half 
character width. It divided the horizontal data range (51 in this example) by the width of the 
viewport in GDU's and multiplies the quotient by the character width in GDU's divided by 
two (1.55/2). The result, placed in CI, is half a character width in user units. The vertical 
offset distance is determined in a similar manner. 
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When the graph is drawn (shown above), it is seen immediately that a point s out of ap- 
parently normal range. In some applications, it is useful to select this data velue for editing 
by merely pointing at it. Pressing user definable key 5 begins an editing mode which allows 
this to be done. 

Whenever the editing mode is entered by pressing key 5, the arrow pointer aopears on the 
display at the last position of the graphic point. After the program graphs the data in array 
A, the cursor is placed in the home position. If key 5 is pressed then, the pointer will appear 
in the home position in the upper left corner of the display. User keys 1, 2, 3, and 6 change 
the pointer's position. Key 1 moves it up; key 6 moves it down; key 2 movei; it to the left; 
and key 3 moves it to the right. When each key is pressed in lower case, the pointer is moved 
.5% of the window size in the appropriate direction. When the key is pressed in upper case, 
the pointer is moved 5% of the window size in each direction. Holding any key down enters 
commands into the GS faster than they can be processed. It is best to move the arrow by 
tapping the desired key repeatedly, rather than by holding the key down. Wlien the pointer 
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is as close as possible to the data point to be changed, press user key 9. This directs the pro- 
gram to search all the data values to deternnine if the pointer is acceptably close to a data 
value in the array. The pointer disappears while this search is executed. If the program fails 
to find a data value within 1% of the data ranges to the pointer, the program stops execution 
and the flashing rectangular cursor appears at the arrow's last location. If an acceptable 
match is found, the arrow reappears. Key 10 is now pressed to change the selected array 
element. In the upper left corner of the display is printed the index of the element selected, 
the element's current contents, and a request to input a new value. Pressing user key 4 re- 
graphs the data, showing the position of the changed data point. 

In several places, the program uses a non-default display secondary address. The secondary 
address 18, as used in lines 1080, 2160, and 3030, tells the display that one of the 6 char- 
acter fonts in the GS display will be invoked. 

The font determines what characters are actually printed on the display when certain ASCI I 
character codes are sent to it. The normal font, called font number zero, is invoked with 
the following command: PRINT @32,18:0. There are six fonts, numbered through 5. The 
arrow pointer, ASCII character code 124, is printed via font 5. Font 5 is invoked by line 
1080 when the data edit mode is entered. 

The secondary address 24, used in line 22, tells the display to "refresh" a character. The 
statement PRINT @32,24: "A" causes the character A to be written but not stored per- 
manently on the display. Each time that statement is executed, the character "A" is refreshed 
on the display for about % second. If the character "A" is to be observed for more than % 
second, the statement PRINT @32,24; "A" must be executed repeatedly. Since line 22 is 
executed repeatedly, the refreshed arrow character remains steadily visible on the display but 
does not leave any trace when its position is changed. Only the first character of the string 
in the PRINT statement is refreshed. For example, the statement PRINT @32,24: "XYZ" 
will cause only the "X" character to be refreshed. 

Any of the data editing functions described in Section 2 can be incorporated into a program 
of the type listed above. In order to keep this example as simple as possible, only the "change" 
function is implemented. 
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CROSS-HATCHING 

Cross-hatching is a useful technique for highlighting data in certain applications. The clipping 
capability of the Graphic System makes this an easy task. A viewport corre^ionding to the 
area to be cross-hatched is set up. A FOR . . . NEXT loop is then executed, which covers 
the entire display with diagonal lines. The only lines which appear are those which fall in- 
side the viewport. The lines which fall outside the viewport are clipped and do not appear. 
The example below shows how this is done. 



959 INIT 

968 DIH P<4,2) 

978 UIEMPORT 8,130,0,100 

980 UINDOH 0,1300,0.1800 

990 MOUE 800,200 

1000 INPUT e32,24:P(l,l),P<l,2) 

1818 RDRAU 8,400 

1028 INPUT g32,24:P<2,l>,P<2,2) 

1030 R[>RAU 200,0 

1040 INPUT e32,24:P<3,l>,P<3,2> 

1058 RDRAM 0,-400 

I860 INPUT e32,24:P<4,l),P<4,2) 

1070 RDRAM -200,0 

1080 UIEWPORT P<1,1),P<3,1),P(1,2>,P<2,2) 

1090 MOUE 0,0 

1100 SCALE 1,1 

1110 FOR I«-100 TO 100 STEP 5 

1120 HOME 0,1 

1130 DRAM 100,1+100 

1140 NEXT I 

1150 UINDOM 0,1300,0,1000 

1168 UIEUPORT 0,138,0,100 

1170 HOME 

1180 END 



PLOT 50 GRAPHIC PROGRAMMING REV B, SEPT 1978 7-19 



ENHANCEMENTS 
CROSS-HATCHING 




This example fills a rectangle 200 units wide by 400 units high with diagonal lines. The 
lower left corner of the rectangle is located by the MOVE command in line 990. In the 
above example, it is specified to be (800,200). The example has five functional sections: 
initialization (lines 950 through 990), placing the actual display location (in GDU's) of each 
corner of the rectangle into each row of the array P (lines 1000 through 1080), setting up 
the proper scale and viewport for the diagonal lines (lines 1080 through 1 100), drawing the 
diagonal lines (lines 1110 through 1 140), and restoring the original window and viewport 
specifications. Each section is now discussed in more detail. 

The first section dimensions array P, sets up the desired window and viewport, and locates 
the lower left corner of the rectangle by placing the graphic point there. 

The second section draws the rectangle while storing the actual display location of each 
corner into a row of array P. The command used to determine the actual display location 
of the graphic point is INPUT @32,24: X,Y. This command is analogous to the GIN com- 
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mand. The major difference between the two commands is that GIN places the position 
of the graphic point in user data space into the two target variables. INPUT @32,24: X,Y 
places the actual display location of the graphic point in GDU's into the two target vari- 
ables. Executing either of these commands is similar to asking "where is the pen?", except 
that the display and not a plotter is being addressed. GIN returns the locations of the graphic 
point in user data space; INPUT @32,24: returns the actual physical locatioi of the graphic 
point in GDU's, the units used to designate specific locations on the display 



The third section sets up a viewport which coincides with the rectangle which has been drawn 
(line 1080). A SCALE command is executed to ensure the diagonal lines alvi/ays appear at 
the same slope with the same distance between them, regardless of what viewport is defined. 
In this case, VIEWPORT'S only function is to specify where the lines are to be clipped. Before 
a scale command can be executed, the graphic point must be moved to the place where the 
origin or (0,0) point of the new coordinate system is to be located. The MOVE 0,0 at line 
1090 does this. It places the graphic point at (0,0), the lower left corner of both the window 
and viewport. However, because of the revised VIEWPORT command line 1080, the point 
(0,0) is now at the lower left corner of the box drawn on the display. (This can be observed 
by temporarily inserting the following statement into the program: 1095 END. When the 
program stops execution just after line 1090, the flashing cursor will appear at the lower 
left corner of the box drawn on the display, not at the lower left corner of the whole 
display.) When the SCALE command is executed, the new origin of user data space, i.e., the 
point (0,0), will be located at the lower left corner of the box drawn on the display. The 
diagonal lines drawn by the FOR . . . NEXT loop at lines 1110 through 1 140 are drawn 
identically, regardless of the size or location of the box. Statements 1 150 and 1 160 restore 
the window and viewport to their original specifications. 



The next example program, listed below, is identical to the histogram program in Section 3. 
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ie@ INIT 

119 Pf^GE 

12d DIM A(ie),P(4,2) 

136 RESTORE 

148 DATA 10,120,18,90 

1S8 READ U1.U2,U3,U4 

168 A«0 

178 H=e 

188 FOR J«l TO 58 

198 R«=RND<-2) 

208 I«INT<R*ie+l) 

210 A<I)«A<I)+1 

220 M-K MA}< Ad) 

238 NEXT J 

248 UIEWPORT U1,U2,U3,U4 

258 M1«0 

268 U2=ll 

278 U3-0 

280 H4=M*1.2 

298 MIHDOM U1,U2,M3,U4 
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390 AXIS 1,1 

319 FOR K=l TO 18 

329 nOUE K-1,8 

339 GOSUB 1999 

349 NEXT K 

359 HOHE 

369 END 



1890 INPUT M2,24:P(1,1),P(1,2) 

1919 RDRAU 9.«^<K) 

1929 INPUT e32.24:P<2,l),P<2,2^ 

1839 RDRAN 1,9 

1949 INPUT e32,24:P(3,n,P<3,2) 

1959 RDRAU 8,-A(K> 

1969 INPUT e32,24:P(4,l>,P(4,2) 

1979 RDRAU -1,9 

1989 UIEHPORT P<1 , 1),P(3, 1>,P(1 ,2>,P(2,2> 

1999 MOUE Wl,W3 

1199 SCALE 1,1 

1119 FOR I=-190 TO 100 STEP 5 

1120 MOUE 0.1 

1139 DRAH 190,1+100 

1140 NEXT I 

1159 HINDOU U1,N2,U3,N4 
1169 UIEWPORT Ul,ki2,03,U4 
1179 MOUE 0,A<K) 
1189 RETURN 



The major change is that the vertical bars which comprise the histogram are cross-hatched 
with diagonal lines. The subroutine beginning at line 1000 is the same program which was 
just discussed, except that the location and height of each vertical bar is determined by a 
data value in array A. This shows that a cross-hatching capability is easily added to a program 
by including it in a subroutine. 
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IMPLICATIONS OF SCALE 

Drawing pictures with the GS is slightly different from representing data. When drawing a 
picture, it is important that the horizontal and vertical scale be equal. If they are not, ob- 
jectionable distortion results. The aspect ratio of a rectangle is the quotient of its width and 
height. Whenever the aspect ratios of the window and viewport differ, the implied scaling 
factors, horizontal and vertical, will differ also. This was illustrated in Section 1. When 
drawing a picture, the limits in the WINDOW command must be changed whenever the 
viewport aspect ratio changes. If the SCALE command is used, the viewport determines 
only where the picture will be drawn on the display and what the clipping lirnits will be. 
With SCALE, the defined viewport has no direct influence on what the scale factors are. 
The following program serves as an illustration of this characteristic. 

188 INIT 

lie PAGE 

128 RESTORE 

138 DATA 8,138,8,188 

148 READ U1,U2,U3,U4 

158 VIEWPORT Ul,U2,y3,y4 

168 REM DRAW A BOX AROUND THE UIEWPORT 

178 AXIS 

188 AXIS 8,8,138,188 

198 REM CENTER GRAPHIC POINT IN UIEWPORT 

288 MOUE 65,58 

218 REM SPECIFY SCALE (DATA UNITS PER GDU) 

228 SCALE 1,1 

1888 REM DRAW A CIRCLE OF RADIUS 28, CENTERED AT (8,8) 

1818 SET DEGREES 

1828 MOUE 28,8 

1838 FOR I-ie TO 368 STEP 18 

1848 DRAW 28«C0S(I>,28«SIN<I) 

1858 NEXT I 

1868 END 

The INIT statement at line 100 sets up the default window and viewport. Statement 150 
changes the viewport, but the window remains defined as it was in the INIT statement: an 
implied WINDOW 0,130,0,100. The two AXIS statements draw a box arounii the viewport 
so that its limits may be seen in the example programs. When the SCALE conmand is ex- 
ecuted, the entire mapping transformation between user data space and scre6n space is re- 
defined. The new origin, or (0,0) point of this coordinate system is defined to be the posi- 
tion of the graphic point when SCALE is executed. The clipping limits of the viewport, that 
is, the locations in user data space of the viewport edges, are therefore implied by the posi- 
tion of the graphic point relative to the viewport at the time the SCALE corrmand is exe- 
cuted. The MOVE 65,50 command at line 200 thus becomes very important. Because it 
determines the graphic point's location when SCALE is executed, it also determines 
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what clipping limits will be implied by the SCALE statement. The SCALE command ex- 
plicitly specifies scale factors and implicitly specifies clipping limits. In contrast, the 
WINDOW command explicitly specifies clipping limits and implicitly specifies scale factors. 
In all the sample runs which use this program (outputs shown below), the circle drawn by 
lines 1000 through 1060 is always centered in the viewport. This is the case regardless of 
what the viewport has been defined to be. Even though the viewport changes, the circle 
is always the same size and shape. 



138 DATA e,13e,35>65 
RUN 
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13d DATA 8,138,18,90 
RUN 
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136 DATA 46,84,8, lee 
RUN 
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138 DATA 85,136,65,196 
RUN 
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MANIPULATING OBJECTS 

To define an object which is part of a picture, RDRAW and RMOVE commands are used 
most often. These commands permit the most flexibility when manipulating the resulting 
image. There are three ways an object or graphic entity is manipulated: changing its posi- 
tion, changing its orientation, and changing its size. If the object is drawn several times, the 
RDRAW and RMOVE commands which define it are placed in a subroutine. The size, 
orientation and location of the object can then be specified before the subroutine is callesd. 
The following example programs show this process. 

109 INIT 

110 PAGE 

120 DATA di.l3d.@.ied.d, 130.6, 100 

130 READ U1,U2,IJ3,1'4,W1,W2.W3,W4 

140 MIEWPORT Ul,l'2,U3A)4 

150 UINDOU M1.U2.U3,I44 

160 SET DEGREES 

1?0 ROTATE 

180 MOUE 65,50 

190 GOSUB 5000 

200 MOUE 65,25 

210 GOSUB 5000 

220 HOME 

230 END 

5000 REM DRAW TRIANGULAR FIGURE 

5010 RMOME -10,10 

5020 RDRAU 0,-20 

5030 RDRAI4 40,10 

5040 RDRAM -40.10 

5050 RDRAW 30,-12.5 

5060 RETURN 
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Beginning at line 5000 is a subroutine to draw the triangular figure and the extra line it con- 
tains. The MOVE command at statement 180 positions the graphic point in the center of 
the display. Control is passed to the subroutine at line 5000. After the subrcutine draws 
the triangle and returns control, the MOVE at statement 200 is executed. This positions the 
graphic point at the lower center of the display. The subroutine at line 5000 is called again, 
drawing another triangle below the first one. In both cases, the location of llie graphic point 
when line 5000 is executed determines where the triangle is drawn on the di .play. 
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The next example is functionally identical to the previous one except that the lower tri- 



angular figure is rotated. 



198 INIT 
119 PAGE 

12d DATA 9,130,6,180,0,130.9,180 

130 READ U1,M2,U3,IJ4,U1,I42,U3,U4 

140 UIEMPORT yi,U2,U3,M4 

159 UINDOU H1,I42,M3,M4 

169 SET DEGREES 

179 ROTATE 9 

189 HOME 65,59 

199 GOSUB 5998 
299 MOUE 65,25 
219 ROTATE 39 
229 GOSUB 5998 
239 HOME 

249 END 

5089 REM DRAW TRIANGULAR FIGURE 

5910 RMOME -10,19 

5920 RDRAU 9,-29 

5939 RDRAU 49,19 

5949 RDRAM -49,19 

5959 RDRAM 39,-12.5 

5069 RETURN 
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Inserted between the MOVE which positions the lower triangle (statement 200) and the GO- 
SUB 5000 which actually draws the triangle (statement 220) is a ROTATE 30 statement. 
This rotates all subsequent RMOVEs and RDRAWs 30 degrees counterclockwise from their 
normal orientation. As a result, the second triangle is drawn rotated 30 degmes from its pre- 
vious orientation. 



The next example is the same as the previous one except that the window is changed. Its 
height is now 200 units, meaning that the aspect ratio of the window differs from the aspect 
ratio of the viewport. As a result, the horizontal and vertical scaling factors are no longer 
equal. 

im iNiT 

110 PAGE 

123 DATA 3,130,8,130,0, 130,0, 230 

130 READ yi,U2,U3,U4,Wl,W2,W3,M4 

140 UIEHPORT Ul,y2,U3,M4 

150 UINDOU H1,U2,U3,I>I4 

160 SET DEGREES 

170 ROTATE 

180 HOME 65,50 

1S>0 GOSUB 5000 

280 MOVE 65,25 

210 ROTATE 30 

220 GOSUB 5000 

230 HOME 

240 END 

5000 REM DRAW TRIANGULAR FIGURE 

5010 RMOUE -10,10 

5020 RDRAM 8,-28 

5030 RDRAM 40,10 

5040 RDRAM -48,18 

5050 RDRAM 38,-12.5 

5868 RETURN 
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Although both triangles are distorted, the rotated triangle's shape is completely altered. 



8-10 



REV A, SEPT 1978 



PLOT 50 GRAPHIC PROGRAMMING 



PICTURES 
MANIPULATING OBJECTS 



The next example combines positioning, rotation, and scaling. (The window parameters have 
been restored to their previous values. The horizontal and vertical scaling factors are again 
equal.) 



lee iNiT 
na PAGE 

129 DATA 8,136,0,190 

138 RESTORE 

149 READ Ul,U2,y3,U4 

158 VIEWPORT U1,U2,U3,U4 

160 SET DEGREES 

170 FOR 1=8 TO 90 STEP 15 

188 UINDOU 0,119,0,119 

198 MOUE 10+1,15+1 

200 ROTATE 1*4 

218 SCALE 1+1/38. 1+1/30 

220 GOSUB 5088 

230 NEXT I 

240 HOME 

258 END 

5888 REM DRAW TRIANGULAR FIGURE 

5018 RflOUE -18,10 

5828 RDRAW 8,-28 

5838 RDRAW 48,18 

5848 RDRAW -48, 10 

5058 RDRAW 38,-12.5 

5068 RETURN 
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The heart of the example is the FOR . . . NEXT loop at statements 170 through 230. The 
WINDOW statement at line 180 restores a known window, ensuring that the MOVE com- 
mand at statement 190 always places the graphic point consistently on the display. It is this 
statement which determines the position of each triangular figure on the display. The 
ROTATE 1*4 command (at statement 200) specifies the orientation of each triangular 
figure. The SCALE 1+1/30,1+1/30 command (at statement 210) determines the size of each 
figure. Because of the MOVE, ROTATE, and SCALE commands, the same subroutine draws 
the triangular figure with seven different locations, orientations and sizes. 



RDRAW and RMOVE do not intrinsically determine the position, orientation or size of the 
image they draw. For that reason, RDRAW and RMOVE are the most convenient graphic 
commands with which to define objects. 
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REVERSE VIEWPORT 



The example be 


ow shows an irregular four sided figure 


drawn 


in each of tht 


four quarters 


of the display. 


100 PAGE 

lie INIT 

128 MINDOM 8,100,0,50 

130 MIEMPORT 0,65,8,50 

148 GOSUB 1888 

150 UIEWPORT 65,138,0,50 

160 GOSUB 1000 

170 UIEMPORT 0,65,50,100 

188 GOSUB 1000 

190 UIEWPORT 65,130,50,100 

200 GOSUB 1000 

210 HOME 

220 END 

1000 MOUE 90,40 

1810 DRAM 10,40 

1820 DRAM 20,30 

1030 DRAM 90,5 

1040 DRAM 90,40 









1050 RETURN 
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The viewport is changed to alter the figure's position on the display. (This example is very 
different from other examples in this section. The image is drawn solely with absolute 
MOVE and DRAW commands. No RDRAWs and RMOVEs are used at all.) 



The following example is identical to the previous one with three exceptions: the VIEW- 
PORT statements at lines 150, 170, and 190. 

183 PAGE 

118 INIT 

120 MINDOU 3,100,0,50 

130 UIEMPORT 0,65,0,50 

140 GOSUB 1000 

150 yiEMPORT 130,65,0,50 

1£0 GOSUB 1000 

178 UIEHPORT 0,65,100,58 

180 GOSUB 1000 

190 UIEHPORT 130,65,100,50 

200 GOSUB 1000 

210 HOME 

220 END 

1000 MOUE 90,40 

1010 DRAM 10,40 

1020 DRAI4 20,30 

1830 DRAM 90,5 

1040 DRAU 90,40 

1050 RETURN 
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In line 150, the first two arguments of the VIEWPORT statement are reversed. In line 170, 
the second two arguments are reversed. In line 190, both pairs of arguments are reversed. 
The result in each case is a corresponding reversal of the displayed image. If the first two 
viewport arguments (which specify the horizontal location of the viewport) fire reversed, 
the image is reversed horizontally. If the second two arguments (which specily the vertical 
locations of the viewport) are reversed, the image is reversed vertically. 



This capability is useful in applications where the GS must draw symmetrical images. 
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ANOTHER TRANSFORM 

With a Cartesian coordinate system, specifying a point in space requires three coordinate 
values. Specifying a point on a plane, such as the display of the Graphic System, requires 
only two coordinate values. In order to draw three dimensional objects and Eurfaces on the 
GS, the three-value location for each point in space must be transformed into a two-value 
location on the GS display. In effect, the display serves as the mathematical analog of a pane 
of glass. The object or surface of interest is then examined "through" this vi^owplane. 

This transformation process is very similar to the one described in Section 4 where applying 
a transform to data was categorized into two fundamental approaches. If the data in its raw 
form is of no interest, it is transformed when it is input and stored in its transformed state. 
In the second approach, the data is stored and edited in the GS in its original incoming state. 
It is transformed to a new state only when it is graphed. 

Three-dimensional transformations fall into the latter category. In several ways, three- 
dimensional transforms are similar to the polar transform in Section 4. Both are applied just 
before the data is graphed. In both transforms, the minimum and maximum of the raw data 
has no direct proportional relationship to the minimum and maximum of tht; data as dis- 
played on the GS. In both cases, polar and three-dimensional, the minimum:and maximum 
determination for display locations must reflect the transformation being ua;d. Objection- 
able distortion is introduced in both cases if the horizontal and vertical scale factors are 
different. In other words, the aspect ratio of the window must match the aspect ratio of 
the viewport. 
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TRANSFORMATION LIMITATIONS 

Conceptually, the GS display is a single plane, just as an artist's canvas or a photographic 
print is a plane. The process of representing a three dinnensional object on any plane pre- 
vents true depth infornnation about the object from being presented. This flatness creates 
ambiguities which can make the image on the display confusing. Some kind of stereo im- 
aging device, which presents slightly different images to each eye of the viewer, is the only 
way to accurately convey this depth information. 

If a three dimensional object is represented by a set of lines, as is usually the case with com- 
puter driven displays and plotters, there is another significant limitation. In certain circum- 
stances, showing all the edges of the object introduces confusion. 

What is the object shown below? 




It could be any of the following: 






There have been several algorithms written to remove the hidden lines which make the sketch 
of the cube so confusing. These algorithms all require sufficient topological information about 
the object to determine what lines to hide. While such algorithms are beyond the scope of 
this manual, they are discussed in works listed in the Reference Section. 
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PROGRAMMING CONSIDERATIONS 

The three dimensional coordinate system used in each example is the same. 

+z 

+Y 




The positive X axis extends horizontally to the right of the origin. The positive Z axis ex- 
tends vertically from the origin. The Y axis extends horizontally but "into";the paper (as 
depicted above). The positive Y axis is, in effect, the depth axis. This is a ri^it-handed co- 
ordinate system. 



Each example program in this section draws the same object, a variation on Ihe unit cube. 
(The unit cube in standard position is a cube with one corner at the origin of the coordinate 
system, the (0,0,0) point. The diagonally opposite corner is at the point (1,1,1) in the co- 
ordinate system. All the edges of the cube are one distance unit in length.) 




In all views shown of this object, the viewer is looking "down" upon it. It consists of a square 
drawn in the X-Y plane which has an additional line parallel to and 1/2 unitaway from the 
Y axis. The four edges of this square are all one distance unit in length. Thera are four addi- 
tional lines. These form a rectangle which has one corner at the origin or (0,D,0) point, and 
the diagonally opposite corner at the (1,1,1) point. 
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The example programs in this section draw three dimensional objects on the display with 
slightly different methods. However, each program can be separated into the same seven 
steps, shown below: 



1. 3D Data Acquisition 



I 



2. 3D Data Minimum and Maximum Determination 



3. [Select 30 Transform Parameters 



I 



4. Initialize 3D Routine 



Find Minimum and Maximum Values of Displayed Locations 



6. Specify Window Parameters 



7. Draw Data 



In the flow chart, the seven steps have been separated into four logical sections. Each of the 
three example programs in this part of the manual has the structure depicted above. In addi- 
tion, each example program has another feature. The displayed image is automatically scaled 
and positioned such that it could not be any larger and still fit completely on the display. 
This function is performed by the two steps "find minimum and maximum of displayed 
locations", and "specify window parameters", listed above. If this automatic scaling feature 
is inappropriate for a particular application, it is easily removed. 

The steps listed above are appropriately executed in the order shown. Furthermore, the 
paired steps logically go together. The first step in each pair derives or acquires some type 
of data. 

The second step in each pair acts appropriately on that data. Examining the first pair 
of steps (above) provides an example. If the three dimensional data minimums and maxi- 
mums have been determined at some point in the program's execution, there is no 
need to ever re-determine them unless the three dimensional data changes. Likewise, 
once the three dimensional routine is initialized, there is no need to re-initialize it unless 
there is a change in its parameters. However, if either the three dimensional data or 
the transform parameters change, the previously defined window may become inappro- 
priate. Unless the window is intended to be constant, it should be re-defined. 
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Three methods of 3D to 2D transformations are described in this section. In all three 
methods, the structure and statement numbering of the sample programs an; very similar. 



100 



780 



CONTROLLING PROGRAM 



4000 
4550 



THREE DIMENSIONAL ROUTINE INITIALIZATION 



5000 
5300 



THREE DIMENSIONAL TRANSFORMATION 



The controlling program begins at statement 100 and never extends beyond statement 780. 
It has the structure shown in the seven step flow chart. The 3D routine initialization segments 
always begin at statement 4000 and never extend beyond statement 4550. The actual trans- 
formation routines always begin at statement 5000 and never extend beyond statement 

5300. The array always contains the object to be drawn. The array's size and contents are 
identical in all three examples. 



Since the same object is drawn by each program, the statements which perform the "3D 
data acquisition" and "3D data minimum and maximum determination" functions are 
identical in all three examples. They are listed below. 
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189 INIT 

li0 DIH E(3),L<3),0(11,3>,P<3),Q<2,3) 

120 RESTORE 

13d REH ntnnnunnn 

148 REH FILL 3D DATA ARRAV 

158 0=0 

168 DATA 0.5,1,8.5,1,1 

178 READ 0<1,1),0(1,2),0(2,1),0<4,2),0<5,1: 

188 DATA 1,1,1,1 

198 READ 0<5,2),0<6,1>,0<8,3),0<9,1) 

286 DATA 1,1,1,1 

218 READ O<9,2>,O<9,3),O<10,1>,O(10,2) 

228 REM FIND MIN AND MAX OF 30 DATA 

238 Q=-1.8E+300 

240 DATA 1.0E+300,1.0E+300,1.0E+30e 

258 READ Q< 1, 1>,Q(1,2>,Q(1, 3> 

268 FOR 1=1 TO 18 

270 FOR J=l TO 3 

280 Q<1,J>=Q<1,J) MIN 0(1, J) 

298 Q(2,J)=Q<2,J) MAX 0(1, J) 

388 NEXT J 

318 NEXT I 

328 REM tunnnnnnu 



With the exception of the DIM command at statement 110, statements 100 through 320 of 
each example are identical. Statements 100 through 120 perform initialization. Statements 
130 through 210 fill the data array 0. Statements 220 through 310 determine the minimum 
and maximum of the data in each direction. These minimums and maximums are placed in 
array Q arranged as follows: row 1 of Q holds the minimums, row 2 of Q holds the maxi- 
mums, column 1 of Q holds the X minimum and maximum, column 2 of Q holds the Y 
minimum and maximum, and column 3 of Q holds the Z minimum and maximum. In the 
three examples, the minimums are all and the maximums are all 1 . 

ARRAY Q 





COLUMNS 
1 


2 


3 


ROWS 
1 


X 

MINIMUM 


Y 

MINIMUM 


Z 
MINIMUM 


2 


X 

MAXIMUM 


Y 

MAXIMUM 


Z 

MAXIMUM 



For example, the X maximum is contained in Q (2,1 ). 
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The individual 3D point to be transformed is passed to the transformation routine (at state- 
ment 5000) in the three-element array P. The 2D values to be displayed are returned to the 
controlling program in variables X and Y. 

The transformation methods are discussed in increasing order of complex! tti 



346 

346 DATA 45,8.5,8, 136,0, 106 




OBLIQUE PROJECTION 
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348 DATA 35.2,8,-25 




ORTHOGRAPHIC PROJECTION 
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340 DATA 0.8,-1,9.6,0.5,0.5,0.5 




PERSPECTIVE PROJECTION 



The oblique transformation routine occupies the smallest amount of memory space, exe- 
cutes the most quickly, and introduces the most visual distortion. The perspective trans- 
formation routine occupies the largest amount of memory space, executes the most slowly, 
and introduces the least distortion. In all three criteria, the orthographic transformation 
routine falls in between the other two. 
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OBLIQUE PROJECTION 

As used here, the term oblique transformation describes a class of transformations commonly 
used in certain technical drawing applications and variously called "oblique", "cabinet", and 
"cavalier". This class might appropriately be called "shear" transformations because of the 
distortion they introduce. Lines parallel to the X and Z axes are projected onto the view- 
plane with no distortion. Lines parallel to the Y axis, when projected onto the viewplane, 
become lines drawn at an angle to horizontal in the viewplane. This angle is the projection 
angle, variable A in the program. It is typically not less than 30 degrees and not greater than 
45 degrees. The lengths of lines parallel to the Y axis are multiplied by the foreshortening 
factor prior to being drawn. This foreshortening factor is never greater than 1 and is usually 
not less than Vz. With a foreshortening factor of Vi, lines parallel to the Y axis are drawn half 
the length they would be drawn if the foreshortening factor were equal to 1 . 

In technical drawing terminology, the cavalier projection has a projection angle of 45 degrees 
and a foreshortening factor of 1, the cabinet projection has a projection angle of 45 degrees 
and a foreshortening factor of Vz, and the oblique projection has a projection angle of 30 de- 
grees and a foreshortening factor of 1. In this manual, the term oblique is used in a more 
general sense. All surfaces of the object which are parallel to the X-Z plane are drawn un- 
distorted. All surfaces of the object parallel to the X-Y and Y-Z planes are distorted in 
varying amounts. This inherent distortion can be reduced for certain applications by 
specifying a projection angle of greater than 45 degrees and a foreshortening factor less; 
that Va. 

The entire oblique projection program is as follows: 

109 INIT 

118 DIM E<3),LC3>,0ai,3),P(3),Q(2,3) 

120 RESTORE 

130 REM %%%%%%%%%%%%%%%%% 

140 REM FILL 3D DATA ARRAY 

150 0=0 

160 DATA 0.5,1,0.5,1,1 

170 READ 0(1,1),0<1,2),0(2,1>,0(4,2>,0<5,1) 

1S0 DATA 1,1.1,1 

190 READ 0*;5,2),0<6,1),0<8,3),0(9,1) 

200 DATA 1,1,1,1 

210 READ O(9,2),O<9,3),O<10,1>,O<10,2> 

220 REM FIND M IN AND MAX OF 3D DATA 

230 Q=-1.0E+300 

240 DATA 1.0E-t-300,1.0E430e,1.0E-^306 

250 READ 0<1,1>,Q( 1,2). 0(1,3) 

260 FOR 1=1 TO 10 

270 FOR J=l TO 3 

280 Q<1,J)=Q<1,J) MIN 0(1, J) 

290 e<2,J>=Q<2,J) MAX 0(1. J> 

300 NEXT J 

310 NEXT I 

320 REM )k!tX!t4!l!4iX$!fc$!l:)ii!t)k1[l! 

330 REM SPECIFY 3D PARAMETERS - PROJ ANGLE AND FORESHORTENING FACTOR 

346 DATA 45,0.5,0,136,0,106 

358 READ A,F,M1,U2,M3,M4 

369 REM INITIALIZE 3D ROUTINE 
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378 Gosue 4eee 

38e REM ttttuttnnnut 

398 REM SET UP UIEMPORT AND 2D WINDOW 
488 UIEMPORT 8,138,8,160 
418 UINDOU U1,U2,U3,W4 

428 REM tnuttnntnunn 

438 REM MOUE TO FIRST POINT 

448 P<1)«0(1,1) 

458 P<2)»0<1,2) 

468 P(3)=0<1,3> 

478 GOSUB 5888 

488 MOUE X,Y 

498 REM DRf^U 08JECT 

588 FOR I«2 TO 11 

518 P(1>«0(I,1) 

528 P<2)sO<I,2) 

538 P<3)=0<I,3> 

548 GOSUB 5888 

558 DRAH X,Y 

568 NEXT I 

578 HOME 

588 END 

4888 REM FIND SCALING FACTOR 

4818 SET DEGREES 

4828 REM FIND WHETHER HORIZ OR UERT IS LARGEST SIZE OF IMAGE 

4838 REM H«HORIZONTAL IMAGE SIZE, U^UERTICAL IMAGE SIZE 

4848 H=8<2,l>-Q(l,l>+<Q<2,2)-ea,2)>*F*C0S<A) 

4858 U=Q(2,3>-Q<l,3>+<Q(2,2)-e(l,2))*F*SIN(ft> 

4868 IF H/U>1.3 THEN 4166 

4878 REM UERTICAL LARGER 

4888 S=<W4-W3)/U 

4898 GO TO 4128 

4188 REM HORIZONTAL LARGER 

4118 S<<M2~M1>/H 

4128 H«S»F»COS(A) 

4138 U«StF«StN(A> 

4148 RETURN 

5688 REM TRANSFORM FROM DATA X,Y,Z TO SCREEN X,Y 

5618 X«H1+P(1>«S+P<2)«H 

5626 Y«M3+P(3)*S+P<2)»M 

5636 RETURN 



Statements 330 through 370 initialize the projection angle A, the foreshortening factor F 
and the window parameters. The initializing routine starting at statement 4D00 computes 
the scale factor for the image. The computation of the scaling factor is based on the as- 
sumption that anything drawn on the display should be as large as possible within the 
specified window. The initialization section determines whether the limitinl) factor on the 
size of the displayed image is the viewport height or viewport width. The I F command at 
statement 4060 is the decision point. The scale factor is calculated on that basis. The re- 
maining two statements in the section (4120 and 4130) merely calculate constants which 
allow faster execution of the two transformation statements (5010 and 5020). 
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When using oblique projection, the minimums and maximums in the display's coordinate 
system do not need to be computed. They are specified in advance. This is the oblique pro- 
jection's principal advantage over the orthographic and perspective transformations. The 
initialization and transformation statements ensure that no data will be drawn outside the 
specified window. As a result, defining the window requires one WINDOW command and 
nothing else. Of course, the window height and width must have the same ratio as the view- 
port height and width if distortion is to be minimized. 

Statements 430 through 480 transform the first point in array and position the graphic 
point there with a MOVE command. 

The remainder of the object is drawn with the FOR . . . NEXT loop at statements 500 
through 560. As with the other examples in this section, the routine required to transform 
three data points into two data points for graphing begins at statement 5000. 
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WINDOW PARAMETERS 

As stated previously, the aspect ratio of the viewport must match the aspecl ratio of the 
window. This requirement complicates the initialization of the parameters used by the 
WINDOW command in the orthographic and perspective transformations (statements 390 
through 610 in both examples). 



389 REH tnnnntntnu 

399 REM FIND «IN AND MAX IN UIEWPLANE'S COORDINATE SYSTEM 
498 DATA 1.0E+39e,-1.8E+399, 1.9E+300,-1.0E+300 
410 READ X1,X2,Y1,Y2 

429 FOR I^l TO 2 

430 FOR J»l TO 2 

449 FOR K«l TO 2 

450 P<D«Q<1,1> 
460 P<2>»Q(J,2> 
470 P(3>»Q(K,3) 
430 G03UB 5900 
490 X1=X1 MIN X 
500 X2-X2 MAX X 
510 Y1=Y1 MIN Y 
520 Y2=Y2 MAX Y 
530 NEXT K 

540 NEXT J 

550 NEXT I 

560 REM SET UP UIEWPORT AND 2D WINDOW 

570 UIEWPORT 0,130,0.190 

580 IF <X2-X1)/<Y2-Y1)>1.3 THEN 619 

590 WINDOW <X2+X1)*9.5-9.65*<Y2-V1>,CX2+X1>«9.5+9.65*<Y2-Y1>,Y1.Y2 

600 GO TO 630 

610 WINDOW Xl,X2,<Y2+Yl)*0.5-<X2-Xl).''2.6,<Y2+Yl)*0.5+<:X2-Xl>/2.6 

629 REH tttmnnnunnn 
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Since there is no simple way to determine where on the display the transformed image will 
appear before the three dimensional transformations are initialized, the window minimums 
and maximums must be computed from the three dimensional minimums and maximums 
after the transform is initialized. This is precisely the function performed by lines 390 
through 610. Each corner of the cube created by the three dimensional minimums and maxi- 
mums, a total of eight points in three dimensional space, is transformed into two dimen- 
sional coordinates. The window parameters are then derived from the minimums and maxi- 
mums of these two dimensional values. The parameters are defined (in the two WINDOW 
commands in statements 590 and 610) such that the image on the display is always centered 
in the viewport. 

The remainder of the main line program (statements 630 through 760) simply moves the 
graphic point to the location of the first transformed point and draws the object. 



€28 REK unttututnuun 

638 REM HOME TO FIRST POINT 

649 P<1>«0<1,1) 

65e P<2)=0(1,2) 

668 P(3)«0(l,3) 

670 GOSUB 5898 

688 MOUE X,Y 

698 REM DRAM OBJECT 

789 FOR 1=2 TO 11 

710 P(1)=0(I,1) 

720 P<2>=0(I,2) 

730 P<3)=0(I,3) 

740 GOSUB 5090 

750 DRAW X,Y 

760 NEXT I 

770 HOME 

780 END 
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ORTHOGRAPHIC PROJECTION 

Orthographic projection has less inherent distortion than oblique projectioF. In orthographic 
projection, a straight line connecting a point on the object and the projection of this point 
on the viewplane is always perpendicular to the viewplane. 




As a result of this, all lines connecting points on the object to the corresponding points on 
the viewplane are parallel. I n an actual three dimensional situation, this could happen only 
if the observer were an infinite distance away from the object being viewed. Having all the 
lines of projection parallel introduces ambiguities of perspective similar to tiiose which 
occur when viewing an airplane silhouette at great distance. In that situation, it is often easy 
to recognize the silhouette as an airplane but difficult to tell whether it is coming toward 
you or going away. 
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Listed below are the statements which comprise the heart of the orthographic example. 



338 REM SPECIFY 3D PARAMETERS - THREE ROTATION ANGLES 
346 DATA 35.2,8,25 
353 READ A1,A2,A3 

4009 SET DEGREES 

4010 C1=C0S(A1) 
4020 S1=SIN<A1> 
4030 C2=C0S<A2) 
4040 S2=SIN<A2> 
4050 C3=C0S<A3> 
4060 S3=SIN(A3> 
4070 RETURN 

5000 REM TRANSFORM P< 1 >,P<2)!,P<3) INTO ,K,Y 

5010 X=C2*C3*P(:i)-C2*S3*P<2)+S2*P<3> 

5020 Y=kSl*S3-Cl*S2*C3>1;P(l) + ';Sl*C3+Cl*S2*S3>*P(2>+Cl*C2*P(3) 

5030 RETURN 



The initialization section (beginning at statement 4000) requires three parameters. They are 
rotation angles which specify the object's orientation when viewed: a rotation angle around 
the X axis (A1), a rotation angle around the Y axis (A2), and a rotation angle around the Z 
axis (A3). The rotation specified is in a consistent direction around each axis. If the thumb 
of the right hand is pointed in the positive direction of the axis to be rotated around, the 
fingers curl in the direction of a positive angular rotation. Inherent in the transformation 
section (beginning at statement 5000) is the order in which the rotations are performed: 
first around the Z axis, then around the Y axis, and finally around the X axis. This ordering 
is fixed in the transformation equations and has an important characteristic: it is not com- 
mutative. A rotation around X followed by a rotation around Y produces a different 
orientation than a rotation around Y followed by a rotation around X. The ordering used 
in this example (first Z, then Y, then X) is one of six ways to specify the order in which 
the rotations occur. 

When the orientation angles are all zero, the object's coordinate system is oriented as de- 
scribed earlier in this section. The 3D Z axis is parallel to the display's vertical axis (with 
the positive direction being up), the 3D X axis is parallel to the display's horizontal axis 
(with the positive direction being to the right), and the 3D Y axis is perpendicular to the 
display's surface (with the positive direction being "into" the display). 
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When rotation angles are specified, they occur relative to this coordinate syEtem which al- 
ways remains fixed, regardless of the specified rotation angles. An example is the case of a 
rotation around the Z axis followed by a rotation around the X axis. Regardless of the ob- 
ject's orientation after its rotation around the Z axis, the X axis it is then rotated around 
will always be parallel to a horizontal line on the display's surface, not to the rotated X 
axis of the object's coordinate system. 

For example, the object is rotated 90 degrees around the Z axis followed by 90 degrees 
around the X axis. This produces the image below. 




The object's X-Y plane becomes parallel to the display's surface. The visibilily of the diag- 
onal line proves this to be the case. If the X axis rotation occurred around the rotated X 
axis, the object's X-Y plane would become perpendicular to the display's surface, making 
the diagonal line invisible. 

Of interest is a particular orthographic projection. A rotation around the Z axis of 45 de- 
grees followed by a rotation around the X axis of 35.2 degrees produces an fsometric pro- 
jection, common to a variety of drawing applications. 

For reference, a complete listing of the orthographic projection example is gi\/en: 
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lee iNiT 

119 DIM 0<11,3),P<3).Q(2.3) 

126 RESTORE 

13d REM ntUUUttUUU 

149 REM FILL 3D DftTA ARRAY 

159 O«0 

169 DATA 9.5,1,9.5,1,1 

179 READ 0<1, 1), 0(1, 2>, 0(2,1), 0(4, 2>, 0(5,1) 

189 DATA 1,1,1,1 

199 READ 0(5, 2), 0(6,1), 0(8, 3), 0(9,1) 

299 DATA 1,1,1,1 

219 READ 0(9, 2), 0(9, 3), 0(10,1), 0(19, 2) 

229 REM FIND MIN AHO MAX OF 3D DATA 

230 Q=-1.9E+300 

240 DATA 1.0E+3e9,1.8E+3e0,1.0E+300 

259 READ Q(l, 1),Q(1.2),Q(1, 3) 

260 FOR 1=1 TO 10 
270 FOR J«l TO 3 

289 Q(1,J)=Q(1,J) MIN 0(1, J) 

290 Q(2,J)=Q(2,J) MAX 0(1, J) 

300 NEXT J 
310 NEXT I 

329 REM tumtnnunnt 

338 REM SPECIFY 3D PARAMETERS - THREE ROTATION ANGLES 

349 DATA 35.2,9,25 

359 READ A1,A2,A3 

369 REM INITIALIZE 3D ROUTINE 

378 GOSUB 4888 

388 REM ttntuntnntn 

398 REM FIND MIN AND MAX IN M I ENPLANE 'S COORDINATE SYSTEM 
488 DATA 1.9E^3e9,'-1.9E-^398, 1.9E^300,-1.9E-»-3O9 
419 READ X1,X2,Y1,Y2 
428 FOR 1«1 TO 2 
438 FOR J»l TO 2 

440 FOR K»l TO 2 

458 PC1>»Q<I,1) 

460 P<2)=Q(J,2) 

470 P(3>>Q(K,3) 

480 GOSUB 5989 

496 X1=X1 MIN X 

560 X2*=X2 MAX X 

518 Y1«Y1 MIN Y 

528 Y2=Y2 MAX Y 

530 NEXT K 

548 NEXT J 

556 NEXT I 

560 REM SET UP UIEWPORT AND 2D WINDOW 

576 UIEWPORT 8,130,6,100 

580 IF (X2-X1)/(Y2-Y1)>1.3 THEN 610 

590 WINDOW (X2+X1)*0.5-0.65*(Y2-Y1),(X2+X1)*0.5+0.65*(Y2-Y1),Y1.Y2 

600 GO TO 630 

610 WINDOW Xl,X2,(Y2+Yl)*0.5-(X2-Xl)/2.6,(Y2+Yl)1;0.5+(X2-Xl).-'2.t; 

620 REM tnmttnntntuuu 

636 REM MOME TO FIRST POINT 
648 P(1>=0(1,1) 
658 P(2)«0(l,2) 
668 P<3)«0(1,3) 
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678 GOSUB 5888 
688 nOUE X,Y 
698 REM DRAU OBJECT 
788 FOR I«2 TO 11 
718 P<l)=0<I,l) 
728 P<2)»0(I,2) 
738 P(3)=0<I,3) 
748 GOSUB 5888 
758 DRAM X,Y 
768 NEXT I 
778 HOME 
788 END 

4888 SET DEGREES 

4818 C1«C0S<A1) 

4828 S1=SIN(A1) 

4838 C2«C0S<A2> 

4848 S2«SIN<A2> 

4058 C3«C0S<A3) 

4860 S3«SIN<A3) 

4870 RETURN 

5888 REM TRANSFORM P<1>,P(2),P<3> INTO X,Y 

5810 X=C2»C3*P< 1 >-C25ltS3*P(2>+S2*P<3> 

5020 Y=<S1»S3-CUS2*C3)*P(1) + <S1»C3+C1*S2*S3)*P(2)+CUC2*P<3) 

5030 RETURN 



Listed below are the equations wliicii cause rotation first around the X axis, then around the 
Y axis, then around the Z axis. These can be substituted for similarly numbered statements 
in the listing above. 

5890 REM TRANSFORM P(1>,P(2),P<3) INTO X,Y 

5010 X=C3*C2*P(i;' + <C3*S2*Sl-S3*Cl>*P(2> + (:C3*S2*Cl+S3*CJ>*Pf3'> 

5020 Y«-S2*P(1>+C:2*S1.*P<:2>+C2*C1*P(3^ 

5038 RETURN 
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TRUE PERSPECTIVE 

The only transformation which does not introduce artifical distortion is a true perspective 
transformation. The controlling program in the perspective example (statements 100 through 
780) is identical to that of the previous orthographic example. The only exceptions are 
statements 340 and 350, a DATA statement and a READ statement. 

340 DATA 0.8,-1,0.6,8.5,0.5,0.5 

350 READ E(1>,E<2),E(3>,L<1),L(2),L(3) 

These are the parameters used to initialize the transformation. The array E contains the 
location in three dimensional space of the observer's eye. The array L contains the location 
in three dimensional space of the point toward which the eye is looking. This point should 
be close to the center of the scene being viewed. This will ensure the minimizing of a certain 
type of distortion, the kind seen at the edges of photographs taken with extreme wide 
angle lenses. 

In order to depict scenes in true perspective, a Renaissance artist would observe his sub- 
ject through a pane of glass, marking where the lines between his eye and his subject passed 
through the pane. 




The algorithm in this example duplicates that process mathematically: 
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326 REM nuunuuntu 

330 REM SPECIFY 3D PARAMETERS - EVE POSITION & POINT TO BE LOOKED AT 

340 DATA 0.8, -1,0. 6, 0.5, 0.5, 0.5 

350 READ E(1),E<2>,E<3>,L(1>,L(2),L(3) 

360 REM INITIALIZE 3D ROUTINE 

370 GOSUB 4000 

380 REM UUUttUttttUt 

4000 REM 3D TO 2D PERSPECTIUE INITIALIZATION 

4010 REM MUST BE RUN BEFORE USING TRANSFORM ROUTINE AT 59^0 

4020 REM PURPOSE: 1. FIND LOCATION AND ORIENTATION OF UIEWPLANE 

4930 REM 2. DEFINE 2D COORDINATE SYSTEM OH MlEllPLANE 

4040 REM E IS UIEWER'S EYE LOCATION IN 3 SPACE 

4050 REM L IS 3 SPACE POINT BEING LOOKED AT BY MIEMER-S EVE 

4060 DELETE Tl , T2,T3.T4,T5 

4070 DIM T1(3>,T2(3>'.T3<3),T4(3>,T5<3) 

4080 IF E<1><>L<1> OR E<2?<>L<2>'THEN 4128 

4099 PRINT "E AND L LIE IN SAME VERTICAL LINE " 

4109 PRINT "PLEASE CHANGE ONE OF THE FOLLOWING: Ea).E<2>,ta> OR L<2V' 

4110 END 
4120 REM 
4130 T3«E-L 

4140 REM T3 IS NOW SECTOR FROM L TO E 

4150 T7«0 

4160 FOR T9»l TO 3 

4170 T7=T7+T3(T9>t2 

4180 NEXT T9 

4190 T7*SQRa7> 

4200 REM T7 IS NOW DISTANCE FROM L TO E 

4210 T2=T3/T7 

4220 REM T2 CONTAINS DIRECTION COSINES OF NORMAL VECTOR TO UIEWPLANE 

4240 REM PLACE UIEWPLANE HALF WAY BETWEEN E AND L 

4250 T6=T7/2 

4260 REM T6 IS DISTANCE FROM E TO UIEWPLANE 



4276 T3«T3»<T6/T7) 

4289 T1=E-T3 

4290 REM Tl IS THE INTERSECTION OF UIEWPLANE AND LINE FROM E TO L 
4300 REM DEFINE Tl TO BE ORIGIN OF UIEWPLANE'S 2D COORDINATE SYSTEM 
4310 REM 

4320 REM NOW DEFINE "UP" IN UIEWPLANE S 2D COORDINATE SYSTEM 

4330 T3=L 

4348 T3(3)«T3<3)+1 

4350 REM T3 IS NOW ENDPOINT OF THE UECTOR (6.0,1) RELATIVE TO L 

4360 REM PROJECT ONTO UIEW PLANE 

4370 GOSUB 5170 

4380 REM T3 IS NOW 3 SPACE POINT DEFINED TO BE "ABOUE" PLAHE'S ORIGIN 

4390 REM 

4400 T7='0 

4410 FOR T9=l TO 3 

4420 T7=T7+<T3(T9>-Tl(T9>)r2 

4439 NEXT T9 

4449 T7=S0R<T7) 

4450 REM T7 IS NOW DISTANCE FROM Tl TO T3 
4460 REM 

4470 T3=T3-T1 
4480 T5«T3/T7 
4490 REM T5 NOW CONTAINS DIRECTION COSINES OF UIEWPLANE'S 'VERTICAL" 
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4588 REM CROSS PRODUCT WITH DIEWPLANE'S NORMAL UECTOR IS "HORIZONTAL" 

4518 T4<1)«T5(2>*T2(3)-T5<3>*T2(2> 

4528 T4<2)»T5<3>*T2(1)-T5<1>*T2<3> 

4538 T4(3)«T5<n*T2<2)-T5(2>*T2<l) 

4548 REM T4 CONTAINS DIRECTION COSINES OF UlEUPLANE'S "HORIZONTAL" 

4558 RETURN 

4568 REM 

5888 REN ENTRY POINT FOR 3D TO 2D TRANSFORM 

5810 REM P CONTAINS 3 SPACE COORDINATES OF POINT 

5828 REM TO BE TRANSFORMED TO 2D COORDINATES OF UIEWPLANE 

5838 T3-P 

5848 REM PROJECT INPUT POINT ONTO VIEWPLANE 

5858 GOSUB 5178 

5868 REM 

5878 REM COMPUTE 2D COORDINATES OF PROJECTED POINT 

5888 K=>8 

5898 Y=8 

5188 FOR T9«l TO 3 

5118 X=X+<T3(T9)-T1(T9))*T4(T9> 

5128 YsY+(T3(T9)-Tl<T9))*T5<T9) 

5138 NEXT T9 

5148 RETURN 

5158 REM INTERNAL ROUTINE: FIND 3 SPACE POINT WHERE LINE FROM 

5168 REM T3 TO E INTERSECTS UIEWPLANE 

5178 T7«8 

5188 T8»8 

5198 FOR T9«l TO 3 

5288 T7=T?+(T1(T9)-T3<T9)>*T2(T9) 

5218 T8=T8+<E<T9)-T3<T9))*T2(T9) 

5228 NEXT T9 

5238 IF T8>e THEN 5268 

5248 PRINT "E IS TOO CLOSE TO POINT BEING UIEHED" 

5258 END 

5268 T7«T7/T8 

5278 FOR T9«l TO 3 

5288 T3(T9>«<E<T9>-T3<T9))«T7+T3<T9) 

5298 NEXT T9 

5388 RETURN 
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5848 REH PROJECT INPUT POINT ONTO UIEWPLANE 

5858 GOSUB 5178 

5868 REN 

5878 REM CONFUTE 2D COORDINATES OF PROJECTED POINT 

5889 X«0 

5898 V=8 

5188 FOR T9«l TO 3 

5118 X=X+<T3<T9)-T1<T9>>*T4<T9> 

5128 Y'=Y+(T3<T9>-T1<T9>)*T5<T9> 

5138 NEXT T9 

5140 RETURN 

5159 REM INTERNAL ROUTINE: FIND 3 SPACE POINT WHERE LINE FROM 

5168 REM T3 TO E INTERSECTS UIEWPLANE 

5170 T7=8 

5180 T8=0 

5190 FOR T9=l TO 3 

5288 T7=T7+<T1<T9>-T3(T9)>1:T2<T9> 

5218 T8=T8+(E(T9>-T3<T9) )*T2<T9) 

5228 NEXT T9 

5238 IF T8>e THEN 5268 

5240 PRINT "E IS TOO CLOSE TO POINT BEING UIEWED" 

5258 END 

5268 T7«T7/T8 

5270 FOR T9=l TO 3 

5288 T3<T9)=(E(T9)-T3(T9>)*T7+T3(T9> 

5298 NEXT T9 

5388 RETURN 



The initialization section (statements 4000 through 4550) has one error ternination: state- 
ment 41 10. The routine must have a direction to call "up". In statement 4S40, a line pointing 
up is defined to be parallel to the Z axis, with "up" being the positive Z diCoction. If the 
line between E and L is parallel to the Z axis, the program cannot define wtiich way is up. 
The I F statement at line 4080 prevents this from happening. 



The transformation section also has one error termination: statement 525Q If a point in the 
object being viewed is at or behind E, the transformation produces inappraoriate results. The 
check at statement 5230 prevents this occurrence. 

Both the initialization and transformation sections include REMARK statements which suf- 
ficiently describe the mathematical operations being performed. A background in the ap- 
propriate mathematics will permit a complete understanding or the algorithm used in these 
routines. 

A complete listing of the perspective projection program follows. To help ^n understanding 
the algorithm used, an excessive number of REMARK statements have bem^ included. These 
are superfluous and may be removed without affecting program execution. 
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188 INIT 

}y g^5^E<3),L<3),0<ll,3),P<3),Q(2,3) 

138 REM tnutntutnnt 

140 REM FILL 3D DATA ARRAY 

158 ObS 

168 DATA 8.5,1,8.5,1,1 

\lt ^!$5 9<}'1>'0<1,2),0(2,1),0<4,2),0<5,1) 
188 DATA 1,1,1,1 

198 READ 0(5,2), 0<6,1),0<8,3), 0(9,1) 

288 DATA 1,1,1,1 

218 READ 0(9, 2), 0(9, 3), 0(10,1), 0(18, 2) 

228 REM FIND MIN AND MAX OF 3D DATA 

238 Q=-1.0E+3e0 

240 DATA 1.0E+300,1.0E+30e,1.0E+30e 

250 READ Q(l,l),e(l,2>,Q(l,3) 

260 FOR 1=1 TO 18 

270 FOR J=l TO 3 

280 Q(1,J)=Q(1,J) MIK 0(1, J) 

298 Q(2,J)=Q(2,J) MAX 0(1, J) 

388 NEXT J 

318 NEXT I 

328 REM ttttntttunuu 

Ml 5S!o f l*^^fV? S^^'^S^I^S^- ^^'^ POSITION 8, POINT TO BE LOOKED AT 
iJ^B fHlH o. o,"! ,o. 6,0. 5,0.5,0. 5 

358 READ E(1),E(2),E(3),L(1),L(2),L(3) 

368 REM INITIALIZE 3D ROUTINE 

378 GOSUB 4888 

388 REM tttttUUtnUtU 

398 REM FIND MIN AND MAX IN UIEWPLANE'S COORDINATE SYSTEM 

480 DATA 1.0E+380,-1.8E+30e,1.8E+30e,-1.0E+30e 

418 READ X1,X2,Y1,Y2 

428 FOR I»l TO 2 

438 FOR J«l TO 2 

448 FOR K«l TO 2 

458 P(1)»8(I,1) 

468 P(2)=Q(J,2) 

478 P(3)«Q(K,3) 

488 GOSUB 5888 

498 X1«X1 MIN X 

588 X2»X2 MAX X 

518 Y1«Y1 MIN Y 

528 Y2»Y2 MAX Y 

538 NEXT K 

548 NEXT J 

558 NEXT I 

560 REM SET UP MIEWPORT AND 2D WINDOW 

570 UIEWPORT 0,138,0,100 

580 IF (X2-X1)/(Y2-Y1>>1.3 THEN 618 

590 WINDOW (X2+X1>*0.5-8.65*(Y2-Y1),(X2+X1)*0.5+0.65*(Y2-Y1),Y1,Y2 
680 GO TO 630 

618 WINDOW Xl,X2,(Y2+Yl>*0.5-(X2-Xl>/2.6,(Y2+Yl)*0.5+(X2-Xl)/2.6 

628 REM tnttutttntuuut 

630 REM MOUE TO FIRST POINT 

640 P(1)=0(1,1> 

658 P(2)«=0(l,2) 

668 P(3)=0(l,3) 

678 GOSUB 5888 

688 MOUE X,Y 

698 REM DRAW OBJECT 
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768 FOR 1-2 TO 11 

719 P<1>=»0<I,1) 

720 P<2)»0(I,2) 
73e P<3)=0(I»3) 
748 GOSUB 5888 
758 DRAH X)V 
768 NEXT I 

778 HOME 
788 END 



4888 REM 3D TO 2D PERSPECTIME INITIALIZATION 

4818 REM MUST BE RUN BEFORE USING TRANSFORM ROUTINE AT 580fe 

4829 REM PURPOSE: 1. FIND LOCATION AND ORIENTATION OF UlEWPLAHE 

4838 REM 2. DEFINE 2D COORDINATE SYSTEM ON U I EMPLANE 

4848 REM E IS UIEHER'S EYE LOCATION IN 3 SPACE 

4856 REM L IS 3 SPACE POINT BEING LOOKED AT BY UIEWER'S EYE 

4868 DELETE T1,T2,T3,T4,T5 

4070 DIM T1<3),T2<3),T3<3),T4<3>,T5<3) 

4086 IF ECDOLd) OR E<2)<>L<2> THEN 4126 

4090 PRINT "E AND L LIE IN SAME UERTICAL LINE " 

4100 PRINT "PLEASE CHANGE ONE OF THE FOLLOWING: E<1).E(2),L(1> OR L(2>' 

4110 END 

4128 REM 

4130 T3=E-L 

4148 REM T3 IS NOW UECTOR FROM L TO E 

4158 T7*0 

4168 FOR T9«l TO 3 

4170 T7=T7+T3<T9)t2 

4180 NEXT T9 

4190 T7«SQR<T7) 

4200 REM T7 IS HOW DISTANCE FROM L TO E 

4210 T2«T3/T7 

4220 REM T2 CONTAINS DIRECTION COSINES OF NORMAL UECTOR TO UIEHPLANE 

4230 REM 

4240 REM PLACE MIEHPLAHE HALF WAY BETWEEN E AND L 

4250 T6*T7/2 

4260 REM T6 IS DISTANCE FROM E TO UIEWPLANE 

4270 T3»T3*CT6/T7) 

4280 T1=E-T3 

4290 REM Tl IS THE INTERSECTION OF UIEWPLANE AND LINE FROM E TO L 

4300 REM DEFINE Tl TO BE ORIGIN OF UIEMPLANE'S 2D COORDINATE SYSTEM 

4310 REM 

4320 REM HOW DEFINE "UP" IN UIEWPLANE'S 2D COORDINATE SYSTEM 

4338 T3«L 

4348 T3<3)»T3(3)-H 
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4358 REM T3 IS NOW ENDPOINT OF THE UECTOR (6.6,1) RELATIUE TO L 

4360 REM PROJECT ONTO UIEW PLANE 

4378 GOSUB 5170 

4380 REM T3 IS NOW 3 SPACE POINT DEFINED TO BE "ABOME" PLANE'S ORIGIN 

4390 REM 

4400 T7=0 

4410 FOR T9«l TO 3 

4420 T7»T7+<T3(T9)-Tl<T9):-t2 

4430 NEXT T9 

4440 T7=SQR(T7) 

4450 REM T7 IS NOW DISTANCE FROM Tl TO T3 

4460 REM 

4470 T3=T3-T1 

4480 T5=T3/T7 

4490 REM T5 NOM CONTAINS DIRECTION COSINES OF UIEWPLhNE S "UERTICAL" 

4500 REM CROSS PRODUCT WITH UIEWPLAHE'S NORMAL UECTOR IS "HORIZONTAL" 

4510 T4(1)=T5<2>*T2(3)-T5<3)*T2(2> 

4520 T4<2)=T5<3)*T2<1)-T5(1>*T2(3) 

4530 T4(3)=T5<l>*T2(2>-T5(2).1:T2>:i> 

4540 REM T4 CONTAINS DIRECTION COSINES OF UIEWPLANE S "HORIZONTAL" 

4550 RETURN 

45€0 REM 

5000 REM ENTRY POINT FOR 3D TO 2D TRANSFORM 

5010 REM P CONTAINS 3 SPACE COORDINATES OF POINT 

5020 REM TO BE TRANSFORMED TO 2D COORDINATES OF UIEWPLANE 

5030 T3-P 

5040 REM PROJECT INPUT POINT ONTO UIEWPLANE 

5050 GOSUB 5170 

5060 REM 

5070 REM COMPUTE 2D COORDINATES OF PROJECTED POINT 

5080 ){«0 

5090 Ys0 

5100 FOR T9«l TO 3 

5110 X«X+<T3<T9)-T1<T9))*T4<T9) 

5120 Y*Y+(T3<T9)-T1<T9))*T5(T9> 

5130 NEST T9 

5140 RETURN 

5150 REM INTERNAL ROUTINE: FIND 3 SPACE POINT WHERE LINE FROM 

5160 REM T3 TO E INTERSECTS UIEWPLANE 

5170 T7=0 

5180 T8«0 

5190 FOR T9=l TO 3 

5200 T7»T7+<T1(T9)-T3<T9)>*T2<T9) 

5210 T8=T8+(E(T9)-T3(T9))!|!T2<T9> 

5220 NEXT T9 

5230 IF T8>0 THEN 5268 

5240 PRINT "E IS TOO CLOSE TO POINT BEING UIEWED" 

5250 END 

5260 T7=T7/T8 

5270 FOR T9=l TO 3 

5280 T3<T9)=(E<T9>-T3a9:0*T7+T3a9> 

5290 NEXT T9 

5300 RETURN 
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GLOSSARY 



TERM 

Accumulator 

Algorithm 
Argument 

Arithmetic Operator 

Array 

Array Variable 

ASCII Code 

Assignment Statement 
BASIC 

Binary String 
Bit 

Byte 
Character String 



DEFINITION 

A temporary storage area used for storing a number, summing 
it with another number, and replacing the firet number with 
the sum. 

A step-by -step method for solving a given problem. 

A value operated on by a function or a keyword. Also called 
a parameter. 

Operators which describe arithmetic operations, such as +, — , 

At. 

A collection of data items arranged in a meaningful pattern. 
In the Graphic System, arrays may be one or two dimensional; 
that is, organized into rows, or rows and columns. 

A name corresponding to a (usually) multi-element collection 
of data items. Array variables may be named with the char- 
acters A through Z and AO through Z9. 

A standardized code of alphanumeric characters, symbols, and 
special "control" characters. ASCI I is an acronym for American 
Standard Code for Information Interchange. 

A statement which is used to assign, or give, a value to a 
variable. 

An acronym derived from Beginners All-purpose Symbolic 
Instruction Code. BASIC is a "high level" programming 
language because it uses English-like instructions. 

A connected sequence of 1 's and O's. 

A Binary digit. A unit of data in the binary numbering 
system; a 1 or 0. 

A group of consecutive binary digits operated upon as a unit. 
One ASCII character, for example, is represented by one 
binary byte. 

A connected sequence of ASCII characters, sometimes refer- 
red to as simply "string". 
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Coding 



Concatenate 

Constant 
CRT 

Cursor 

Debug 



Default 



Delimiter 

Dyadic 
Execute 

Expression 



Flowchart 
Function 



DEFINITION 

The process of preparing a list of successive computer in- 
structions for solving a specific problem. Coding is usually 
done from a flowchart or algorithm. 

To join together two character strings with the concatenation 
operator (&) forming a larger character string. 

A number that appears in its actual numerical form. In the 
following expression, 4 is a constant: X = 4 * P 

An abbreviation for Cathode Ray Tube. In the Graphic System, 
the CRT is a "storage" display, as opposed to a "refreshed" 
or TV-like display. 

The flashing rectangular dot matrix on the Graphic System 
display that is located at the position of the "next" character 
to be printed. 

The process of locating and correcting errors in a program; 
also, the process of testing a program to ensure that it oper- 
ates properly. 

The property of a computer that enables it to examine a 
statement requiring parameters, to see if those parameters 
are present; and, finding none, assigning substitute values for 
those parameters. Default actions provide a powerful means 
for saving memory space and time when program statements 
are entered into memory. 

A character that fixes the limits, or bounds, of a string of 
characters. 

Refers to an operator having two operands. 

To perform the operations indicated by a statement or group 
of statements. 

Refers to either numeric expressions or string expressions. 
A collection of variables, constants, and functions connected 
by operators in such a way that the expression as a whole can 
be reduced to a constant. 

A programming tool that provides a graphic representation 
of a routine to solve a specific problem. 

A special purpose operation referring to a set of calculations 
within an expression, as in the sine function, square root 
function, etc. 
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TERM 

Graphic Display Unit 
(GDU) 

Graphics 

Hardware 
Index 



Input 

Instruction 

Integer 
Interrupt 

Iterate 

Justify 

Keyboard 
Keyword 

Line Number 

Logic 

Logical Expression 



Logical Operator 



DEFINITION 

An internal unit of measure representing one one-hundredth 
of the vertical axis on the graphic drawing surface. 

Computer output that is composed of lines rather than letters 
numbers, and symbols. 

The physical devices and components of a computer. 

A number used to identify the position of a specific quantity 
in an array or string of quantities. That is, in the array A, the 
elements are represented by the variables A(1 ), A(2), . . . A(50); 
the indexes are 1, 2, . . . 50. 

Data that is transferred to the Graphic System memory from 
an external source. 

A line number plus a statement (i.e., A line number plus a 
keyword plus any associated parameters). 

A whole number; a number without a decimel part. 

To cause an operation to be halted in such a fashion that it 
can be resumed at a later time. 

To repeatedly execute a series of instructions in a loop until 
a condition is satisfied. 

To align a set of characters to the right or left of a reference 
point. 

The device that encodes data when keys are pressed. 

An alphanumeric code that the Graphics System recognizes 
as a function to be performed. 

An integer establishing the sequence of execution of lines in 
a program. In the Graphic System, line numbers must be in 
the range of 1 through 65,535. 

In the Graphic System, the principle of truth tables, also, the 
interconnection of on-off, true-false elements, etc., for com- 
putational purposes. 

A numeric expression using the logical operators AND, OR, 
and NOT. The numeric expression is arranged in such a way 
that the numeric result is a logical 1 or a logical 0. A logical 
expression may be part of a larger numeric expression in- 
volving relational operators and/or arithmetic operators. 

Operators which return logical I's and O's, specifically, the 
AND, OR, and NOT operators. "True" operations return "1", 
"false" operations return "0". 
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Loop 



Mantissa 



Matrix 



Memory 



Monadic 
Numeric Constant 

Numeric Expression 



Numeric Function 
Numeric Variable 

Operand 

Operator 
Output 



DEFINITION 

Repeatedly executing a series of statements for a specified 
number of times. Also, a programming technique that causes 
a group of statements to be repeatedly executed. 

In scientific notation, the term mantissa refers to that part of 
the number which precedes the exponent. For example, the 
mantissa in the number 1.234E+200 is 1.234. 

A rectangular array of numbers subject to special mathematical 
operations. Also, something having a rectangular arrangement 
of rows and columns. 

This generally refers to the Read/Write Random Access 
Memory that contains BASIC programs and data, as opposed 
to the Read Only Memory which contains the BASIC inter- 
preter. 

Refers to an operator that has only one operand. 

Any real number that is entered as numeric data; also, the 
contents of a numeric variable. 

Any combination of numeric constants, numeric variables, 
array variables, subscripted array variables, numeric functions, 
or string relational comparisons inclosed in parentheses, joined 
together by one or more arithmetic, logical, or relational 
operators in such a way that the expression, as a whole, can 
be reduced to a single numeric constant when evaluated. 

Special purpose mathematical operations which reduce their 
associated parameters (or arguments) to a numeric constant. 

A variable that can contain a single numeric value. Numeric 
variables can be named with the characters A through Z and 
AO through Z9, and can be used in numeric expressions. 

Any one of the quantities involved in an operation. Operands 
may be numeric expressions or constants. In the numeric ex- 
pression A = B-t-4*C, the numeric variables B and C, and the 
numeric constant 4 are operands. 

A symbol indicating the operation to be performed on tvi/o 
operands. That is, in the expression Z -t- Y, the plus sign {+) 
is the operator. 

The results obtained from the Graphic System; also, infor- 
mation transferred to a peripheral device. 



A-4 



REV B, SEPT 1978 



PLOT 50 GRAPHIC PROGRAMMING 



APPENDIX A 
GLOSSARY 
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Parameter 



Peripheral Device 

Program 
Programming 

Relational Operator 



ROM 



Scientific Notation 
Software 

Statement 
String 

String Constant 

String Function 

String Variable 



DEFINITIONS 

A quantity that may be specified as different values; usually 
used in conjunction with BASIC statements. For example, 
in the statement Wl N DOW -50, 50-1 00, 1 00, the para- 
meters are -50, 50, -100, and 100. 

Various devices (Hard Copy Unit, Plotter, Magnetic Tape 
Drive, etc.) that are used in the Graphic System to input data, 
output data, and store data. 

A sequence of instructions for the automatic solution of a 
problem, resulting from a planned approach. 

The process of preparing programs from the standpoint of 
first planning the process from input to outpiit, and then 
entering the code into memory. 

An operator that causes a comparison of two operands and re- 
turns a logical result. Comparisons that are "t'ue" return a 
"1", comparisons that are "false" return a "0 '. The relational 
operators in the Graphic System are =, < >, < , >, =>, 
and < =. 

Read Only Memory. The ROM is that portion of the system 
memory that can not be changed. The information in the 
ROM can only be read. In the Graphic System, the BASIC 
operating system resides in a ROM. 

A format representing numbers as a fractional part, or man- 
tissa, and a power of 10, or characteristic, as in 1.23E45. 

Prepared programs that simplify computer operations, such 
as mathemetics and statistics software. Softwsjre must be re- 
loaded into memory each time the system power is turned on. 

A keyword plus any associated parameters. 

A connected sequence of alphanumeric charatlers. Often 
called a character string. 

A string of characters of fixed length enclosed in quotation 
marks; also, the contents of a string variable. 

Special purpose functions that manipulate chiiracter strings 
and produce string constants. 

A variable that contains only alphanumeric characters, or 
"strings". String variables can be represented by the symbols 
A$ through Z$. They have a default length of 72; i.e., they 
can contain up to 72 characters without being dimensioned 
in a DIM statement. 
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Subroutine 



Subscripted Array 
Variable 

Substring 

System 

Truncate 



User Data Units 



Variable 
Variable Name 



DEFINITION 

A part of a larger "main" routine, arranged in such a way 
tiiat control is passed from the main routine to the subroutine. 
At the conclusion of the subroutine, control returns to the 
main routine. Control is usually passed to the subroutine 
from more than one place in the main routine. 

An array variable followed by one or two subscripts, as in 
A(9), B3(1,2), and Z(N). The subscripts refer to a specific 
element within the array. 

A portion of a larger string; "BC", for example, is a substring 
within the string "ABCD". 

A purposeful collection of interacting components (hardware 
and software) forming an organized whole and performing a 
function beyond the capability of any one component. 

To reduce the number of least significant digits present in a 
number, in contrast to rounding off. For example, the number 
5 is the result of truncating the decimal part of the number 
5.382. 

The units of measure the programmer elects to work with for 
a particular graphing application. These units are established 
in the WINDOW statement as a numeric range for each axis. 
For example the vertical axis range can be set starting at 
"dollars" and ending at 100 "dollars;" the horizontal range 
can be set starting at the "year" 1962 and ending at the year 
"1975." All coordinate values for graphic statements are 
specified in user data units (except VIEWPORT). 

A symbol, corresponding to a location in memory, whose value 
may change as a program executes. 

A name selected by the programmer that represents a specific 
variable. Numeric variables and array variables may be named 
with the characters A through Z and AO through Z9. String 
variables may be named with the characters A$ through 7.$. 
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ERROR MESSAGES 

ERROR MESSAGE 



MESSAGE 
NUMBER 



A system error is generated whenever a firmware failure condition 
occurs. An INIT command and a DELETE ALL command are issued to 
recover firmware program control. An example of firmware failure 
condition occurs when a program is stored on magnetic tape 1 1 binary 
format from a 4052 Graphic System, and the program contains 
commands not available on the 4051 Graphic System. When Such a 
program is loaded into the 4051 Graphic System, the firmware fails, and 
a system error results. 

1 An arithmetic operation has resulted in an out of range number. 
Example: 

1/1.0E-308 

2 A divide by zero operation has resulted in an out of range number. 
Example: 

4/0 

3 An exponentiation operation has resulted in an out of range riumber. 
Example: 

5t1.0E+300 

4 An exponentiation operation involving the base e has resulted in an 
out of range number. 

Example: 

EXP (1.0E+234) 

5 The parameter of a trigonometric function is too large. That is, the 
variable N in the statement A=SIN(N*2*PI) is greater than 65536. 
Example: 

A=SIN(4.2E+5) when the trigonometric units are set to RADIANS. 

6 An attempt has been made to take the square root of a negative number. 
The positive square root is returned by default. 

Example: 
SQR (-4) 

7 The line number in the program line is not an integer within ihe range 
1 to 65535. 

Example: 
REM THIS IS AN INVALID LINE NUMBER 



PLOT 50 GRAPHIC PROGRAMMING rev B, APR 1 980 A-7 



APPENDIX A 
ERROR MESSAGES 



MESSAGE 
NUMBER 

8 



10 



11 
12 
13 

14 
15 
16 



ERROR MESSAGE 

The matrix arrays are not conformable in the current math operation. 
That is, they are not of the same dimension and/or do not have the 
same number of elements. 
Example: 

INIT 

DIM A(2),B(2),C(3) 

A=1 

B=2 

C=A+B 

A previously defined numeric variable can not be dimensioned as an 
array variable without deleting the numeric variable first. 
Example: 

INIT 

B=3 

DIM 8(2,2) 

There is an error in the subscript of a variable due to one of the following 
reasons: 

1. A numeric variable can't be subscripted. 

2. A subscript is out of range. 
Example 1: Example 2: 

INIT INIT 

B=3 DIMA(2,2) 

PRINT B(4) A(2,3)=5 

An attempt has been made to use an undefined DEF FN function. 

There is a parameter error in the CALL statement to a ROM pack. 

A WBYTE parameter is not within the range -255 through +255. 
Example: 
WBYTE 300 

A parameter for the APPEND statement is invalid. 

An attempt has been made to APPEND to a non-existent line number. 

There is an invalid parameter in the FUZZ statement. 
Example: FUZZ 
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MESSAGE ERROR MESSAGE 

NUMBER 

17 There is an invalid parameter in a RENUMBER operation clue to one of 
the following reasons: 

1. The first or third parameter is not a line number within the range 
1 through 65535. 

2. The increment (second parameter) is not within the range 1 through 
65535 or is so large that out of range line numbers are generated 
during the RENUMBER operation. 

3. Statement replacement or statement interlacing will occur if the 
RENUMBER operation is attempted. 

This error may occur during an APPEND operation. 

18 Not used. 

19 There is an invalid parameter in a GOTO, FOR, or NEXT statement. 
Example: 

500 FOR 1=1 to 20 where I has been previously defined as an 
array variable. 

20 The logical unit number specified in the statement is not w thin the 
range through 9. 

Example: 

100 ON EOF (10) THEN 500 

21 The assignment statement is invalid because of one of the following 
reasons: 

1. An attempt has been made to assign an array to a numeric variable. 

2. Two arrays in the statement are not conformable (not of the same 
dimension and/or do not have the same number of elements). 

3. An attempt has been made to assign a character string to a string 
variable and the character string is larger than the dimensioned 
size of the variable. 

22 There is an error in an exponentiation operation because the base is 
less than and the exponent is not an integer less than 256 
Example: 

-10t257.5 

23 An attempt has been made to take the LOG or LGT of a ntmber which 
is equal to or less than 0. 

Example: 
LOG (-1) 
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MESSAGE 
NUMBER 

24 



25 

26 
27 



28 
29 



30 
31 

32 



33 
34 



35 



ERROR MESSAGE 

The parameter of the ASN function or the ACS function is not within 
the range —1 to +1. 
Example: 
ASN (2) 

The parameter of the CHR function is not within the range through 127. 
Example: 

A$=CHR{128) 

Not used. 

The parameter is out of the domain of the function. 
Example: 

A$=STR(X) 
where X has been previously defined as an array variable. 

A REP function parameter is invalid. 

The parameter in the VAL function is not a character string containing 

a valid number. 

Example: 

A=VAL("Hi") 

The matrix multiply operation failed because the arrays are not conformable. 

The matrix inversion failed because the determinant was 0. This error 
is treated as a SIZE error. 

The routine name specified in the CALL statement can not be found. 
Example: 

CALL "FIX IT" where the routine "FIX IT" resides in a ROM pack 

which is not plugged into the system. 

Not used. 

The DATA statement is invalid because of one of the following reasons: 

1. There isn't a DATA statement in the current BASIC program. 

2. There is not enough data in the DATA statement from the present 
position of the pointer to the end of the statement. 

3. An attempt has been made to RESTORE the data statement pointer to 
a nonexistent DATA statement. 

The statements DEF FN, FOR, and ON. . .THEN. . . can not be entered 
without a line number. 
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MESSAGE 
NUMBER 



ERROR MESSAGE 



36 There is an undefined variable in the specified line. A numeric variable 
has not been assigned a value or an array element has not been assigned 
a value. 

Example: 
INIT 

DIM A(2,2) 
A(1,2) =4 
PRINTA 

37 An extended function ROM (Read Only Memory) is required to perform 
this operation. 

38 This output operation cannot be executed because the current BASIC pro- 
gram is marked SECRET. 

39 This operation can not be executed because the Random Access Memory 
is full. Some program lines or variables must be deleted. 

40 Not used. 

41 A SIZE interrupt condition has occurred and an ON SIZE THEN 
statement has not been executed in the current BASIC program. 

42 A PAGE FULL interrupt condition has occurred. 

43 A peripheral device on the General Purpose Interface Bus is requesting 
service and an ON SRQ THEN statement has not been executed in the 
current BASIC program. 

44 The EOl signal line on the General Purpose Interface Bus has been acti- 
vated and an ON EOl THEN statement has not been activaled in the 
current BASIC program. 

45 A ROM pack is requesting service and the ON UNIT for external interrupt 
number 1 has not been activated in the current BASIC program. 

46 A ROM pack is requesting service and the ON UNIT for external interrupt 
number 2 has not been activated in the current BASIC projiram. 

47 A ROM pack is requesting service and the ON UNIT for external 
interrupt number 3 has not been activated in the current BASIC program. 

48 The end of the current file has been reached on an I/O device and an ON 
EOF THEN statement has not been executed in the current BASIC program. 

49 The statement with the specified line number is too long. This error 
situation occurs if an attempt is made to LIST or SAVE a BASIC pro- 
gram which contains a line with more than 72 characters. Sometimes a 
RENUMBER operation can make a line longer than 72 characters. 
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MESSAGE 
NUMBER 

50 
51 



52 
53 



54 



55 



56 



57 

58 

59 
60 
61 



62 



ERROR MESSAGE 

The incoming BASIC program contains a line with more than 72 characters. 

The line number specified in this statement cannot be found or is in- 
valid. 
Example: 

GO TO 500 where the line 500 doesn't exist or PRINT 
USING 100: where line 100 isn't an IMAGE statement. 

Either the specified magnetic tape file doesn't exist or an attempt has 
just been made to KILL the LAST (dummy) file. 

After 10 attempts, the internal magnetic tape unit has been unable to 
read a portion of the current magnetic tape. The tape head has been posi- 
tioned after the bad portion in the file to allow the rest of the file to be 
read. 

The end of the magnetic tape medium has been detected. Marking a 
file longer than the remaining portion of the tape can cause this error. 

An attempt has been made to incorrectly access a magnetic tape file. 
Example: 

Executing an OLD statement when the tape head is positioned in 

the middle of a data file. 

An attempt has been made to send information to a write-protected 
tape. Remove the tape cartridge, rotate the lock-out plug until the black 
arrow points away from SAFE, insert the tape cartridge, and try the 
operation again. 

An attempt has been made to read to or write to a non-existent tape cart- 
ridge. Insert a tape cartridge into the tape slot and try the operation 
again. 

An attempt has been made to read data which is stored in an invalid 
magnetic tape format. The tape format must be compatible with the 
Graphic System standard. 

A program was not found when the OLD statement was executed. 
Not used. 

An attempt has been made to execute an invalid operation on an open 

magnetic tape file. 

Example: 

Executing a MARK statement with the tape head positioned 

in the middle of an open data file. 

There is a Disk File system parameter error. 
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MESSAGE 
NUMBER 



ERROR MESSAGE 



63 There is an error in a binary data header, most likely caused by a mach- 
ine malfunction. 

64 The character string is too long to output in binary format. The length 
is limited to 8192 characters. 

65 A parity error has occurred in the 4052 or 4054 RAM memory. Although 
the error is nonfatal (and the message will not be repeated), further 
operations are unreliable until power has been turned off and back on. 
In the 4051 this error is not used. 

66 The primary address in the specified line is not within the range 
through 255. 

67 An attempt has been made to execute an illegal I/O operation on an in- 
ternal peripheral device. 

Example: 

DRAW @33: 50,50 

68 The diagnostic loader failed. 

69 An input error or an output error has occured on the General Purpose 
Interface Bus. Both the NDAC and NRFD signal lines are inactive high, 
which is an illegal GPIB state. This usually means that thera are no 
peripheral devices connected to the GPIB. 

70 There is an incomplete literal string specification in the format string. 
Example: 

100 IMAGE 6D,5("MARK 

71 A format string is not specified for the PRINT USING operation. 
Example: 

100 IMAGE 6D 

1 10 PRINT USING 100: 23,24,25 
Line 100 should be: 100 IMAGE 3(6D) 

^3 There is an invalid character in the format string specified in the PRINT 

USING statement. 

74 An n modifier in the format string is out of range or is incQr rectly used, 

n modifiers must be positive integers within the range 1 through 1 1 
when used with E field operator and must be within the rarge 1 through 
255 when used with A,D,L,P,T,X,",(, and / field operators. 
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MESSAGE 
NUMBER 

75 



76 



77 



78 



79 



80 



81 



ERROR MESSAGE 

The format string specified in tiie PRINT USING statement is too long 
(i.e., tiiere are too many data specifiers for the PRINT statement). 
Example: 

100 IMAGE 3(6D) 

110 PRINT USING 100:A,B 
Line 100 should be: 100 IMAGE 2(6D) 

Parentheses are incorrectly used in the format string which is specified 

in the PRINT USING statement. 

Example: 

100 IMAGE 2(6D 

110 PRINT USING 100:A,B 
Line 100 should be 100 IMAGE 2(6D) 

There is an invalid modifier to a field operator in the format string which 

is specified in the PRINT USING statement. 

Example: 

100 IMAGE 2(6D),2S 

110 PRINT USING 100:A,B 
Line 100 should be: 100 IMAGE 2(6D),S 
An n modifier is not allowed 

An S modifier is incorrectly positioned in the format string which is 
specified in the PRINT USING statement. The S modifier must always 
be positioned at the end of the format string. 
Example: 

100 IMAGE 4D,S,8A 
Line 100 should be: 100 IMAGE 4D,8A,S 

A comma is incorrectly used in the format string which is specified in 
the PRINT USING statement. 
Example: 

100 IMAGE 6,D,S 
Line 100 should be: 100 IMAGE 6D,S 

A decimal point is incorrectly used in the format string which is specified 
in the PRINT USING statement. 
Example: 

100 IMAGE .3D 

110 PRINT USING 100:812.345 
Line 100 should be: 100 IMAGE FD.3D 

A data type mismatch has occurred in the PRINT USING statement. 
Example: 

100 IMAGE6D,6A 

110 PRINT USING 100: "MARY",26 
Line 100 should be: 100 IMAGE 6A,6D 
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MESSAGE 
NUMBER 



ERROR MESSAGE 



82 A tabbing error has occurred in the format string which is specified in 
the PRINT USING statement. 

Example: 

100 IMAGE 10A,2T,FD 

110 PRINT USING 100: "ENTER DATA",D 
The absolute tab to position 2 specified by 2T in line 100 cannot occur 
because the cursor has already advanced beyond position 2. The tab 
specification must be at least 11T in this case. 

83 A number specified in the PRINT USING statement contains an exponent 
outside the range ± 127. 

Example: 

100 IMAGE FD.3D 

110 PRINT USING 100:8.5E+200 

84 The IMAGE format string was deleted during the PAGE FULL interrupt 
routine. 

85 A portion of the IMAGE format string was deleted or altered during 
the PAGE FULL interrupt routine. 

86 A portion of the data specified in the PRINT statement was deleted 
during the PAGE FULL interrupt routine. 

87 A data item specified in the PR I NT USI NG statement is too large to 
fit into the print field specified in the format string. 

Example: 

100 IMAGE 5A 

110 PRINT USING 100: "HORSE FEATHERS" 
In this example, the string constant "HORSE FEATHERS'* is too large 
to fit into the 5 character field which is specified in line 10(3. 



88 


Not used. 


89 


A ROM pack has issued an error message 


90 


Not used. 


91 


Not used. 


92 


Not used. 


93 


Not used. 


94 


Not used. 


95 


An internal conversion error has occurrec 



specified statement is negative. 

96 An internal conversion error has occurred because a parameter in the 

specified statement is greater than 65535. 
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GRAPHICS AS I/O 



The Graphic System can be considered to be a "central processing unit" which communi- 
cates to various peripheral devices, some of which are internal and some of which are ex- 
ternal. Internal peripheral devices are the keyboard, the tape, the display, and the General 
Purpose Interface Bus. External peripherals are those connected to the Graphic System via 
the GPIB. The Graphic System is very consistent when ASCII information is sent to or re- 
ceived from any peripheral. Implicit in each Graphic System output command (such as 
PRINT) are three functions: 

Any conversion to be performed on the stored data prior to its output. 

Specifying which peripheral is to receive the data. 

Specifying the function to be performed by the peripheral. 

The PRINT command is an example. 

Any data sent to a peripheral via the PRINT command must be converted from internal 
storage form to ASCII characters. The command itself can be used in three forms: 

PRINT 

PRINT @P: 

PRINT @P,S: 

The P in the above forms is the primary address. This number determines which peripheral 
device will receive the data. 

When no primary address is specified (as in the first form of PRINT, above), the PRINT 
command itself specifies a default primary address of 32, signifying the display. When no 
primary address is specified, PRINT sends data to the display. 

The S in the above form is the secondary address. This tells the peripheral what type of data 
to expect and what to do with it. The default secondary address for PRINT is 12, which tells 
the display that it will receive ASCI I characters and that these characters are to be printed 
on the display in their ASCII form. 

Another ASCII output command is DRAW, which performs the same three types of func- 
tions as PRINT: 

Convert data from internal to external form. 

Determine device if no primary address is specified. 

Determine device function if no secondary address is specified. 
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Graphic information is sent to any graphic device as GDU's expressed in theJorm of ASCII 
characters. An important point is that the DRAW command outputs graphic information 
in the same fundamental form that the PRINT command outputs ASCII characters. It is 
useful to compare the DRAW command with the PRINT command. They are listed below 
with their default primary and secondary addresses: 

PRINT@32,12; DRAW@32,20: 

Both commands output ASCII characters. They both send this ASCII information to the 
display (primary address 32). There are, however, two fundamental differences: what is 
done to the information before it is sent out (determined by the keyword) and what the 
display does with the information when received (determined by the second^iry address). 

The secondary address 12 tells the display to print the characters which are equivalent to 
the ASCII characters it receives. The secondary address 20 tells the display to draw a line 
from wherever the graphic point is currently located to a location on the di^jlay specified 
(in GDU's) by the ASCII characters received. 

Enter the following into the Graphic System: 

PRINT @32,12: 65,50 

This command instructs the Graphic System to output the ASCII characters 6 5 and 5 0. 
The primary address of 32 means that characters are sent to the display. The secondary 
address of 1 2 instructs the display to print the characters as received. Now enter the following 
command: 

PRINT @32, 20: 65,50 

This command causes a line to be drawn to the center of the display. The only difference 
between the two commands is the secondary address. Both commands send The same ASCII 
characters to the display. However, the same characters are interpreted differently because 
of the different secondary address. 

Now enter the following commands into the Graphic System: 

INIT 

WINDOW -50,50,-50,50 

DRAW@32,20: 0,0 

The DRAW command causes a line to be drawn to the origin of the user datu space defined 
by the WIN DOW command. The INIT and WINDOW commands (above) defined the user 
data space such that the center of the display corresponds to the location (Q,0) in that data 
space. Therefore, a DRAW 0,0 in this context really is saying "draw a line to the center of 
the display". The center of the display is the location 65,50 in GDU's. So the DRAW com- 
mand must convert user data units into GDU's prior to outputting the graph c information. 
A secondary address of 20 specifies that the ASCI I information received is tit) be interpreted 
by the display as graphic information. 
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If a DRAW command with a secondary address which is not 20 is executed, the display 
will interpret the information it receives differently. 

Now enter the following command into the Graphic System: 

DRAW@32,12: 0,0 

As shown above, a secondary address of 12 instructs the display to interpret the infor- 
mation it receives only as ASCII characters, not as graphic information. When the command 
DRAW @32,12: 0,0 is executed, the numbers 65 and 50 are printed on the display. This 
shows that the user data space location of (0,0) has been transformed into the display 
location of (65,50). 

The above commands demonstrate two principles. One: that graphics are really device 
independent mathematics until the information is sent to a graphic device. Two: graphic 
commands perform several operations on graphic data before it is output. The example 
below shows that these operations require varying amounts of time to perform. (When run, 
the program below calculates for several seconds before any output is displayed. After the 
program has been run once, pressing user definable key one causes the output to be re- 
peated without re-performing the calculations.) Enter the following statements into the 
Graphic System: 

1 GO TO lee 

4 GO TO 310 

lee H>iee 
ue D-ieso/N 

120 DELETE A,B,X,Y,2 

138 OIH A<N>,B<N>,X<N),Y<N),2<N,2> 

140 SET DEGREES 

ISO FOR I>1 TO N 

169 X(I>>I«D 

178 Y<I)«SIN<I»D>+1 

180 NEXT I 

ISO A<D 

208 B<1)«Y<1)-1 

218 FOR I«2 TO N 

228 B<I)«Y<I)-Y(1-1) 

238 NEXT I 

248 D1-138/N 

258 FOR I«l TO N 

268 2<I,1)«I*D1 

278 Z(I,2)«Y<I)«18 

288 NEXT I 

298 PAGE 

388 PRINT "G" 

318 UIEHPORT 8,138,80,188 

328 MINDOU 0,1888,8,2 

330 HOVE 0, 1 

348 RDRAU A,B 

358 VIEWPORT 0,130,48,68 

368 NOVE 8, 1 

378 DRAU X,Y 

388 PRINT 832,21:0,18 

398 PRINT 832,28:2 

480 END 
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The above program demonstrates that there are three fundamental ways to draw a line on 
the Graphic System display: RDRAW (statement 340), DRAW (statement 370) and PRINT 
(statement 390). The program also shows that each of these three commands requires dif- 
fering amounts of time to draw a series of lines. The PRINT command is th'^ fastest be- 
cause its only function is to output ASCII characters. The additional functions performed 
by the DRAW command slow its execution. Whenever graphic information is output with 
the DRAW command, two additional functions must be performed: clipping and trans- 
formation from user data units to GDU's. RDRAW is slower still because it performs two 
more functions: rotation and computing absolute coordinates. (Only absolute graphic infor- 
mation is output. All relative calculations are completed inside the Graphic System prior 
to output.) 

The above example program also demonstrates that PRINT handles arrays differently from 
DRAW and RDRAW. PRINT outputs data from an array in simple sequential order. The 
secondary address of 20 instructs the display to interpret the first ASCII number received 
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as a horizontal location in GDU's, the second ASCII number received as a corresponding 
vertical location in GDU's, the third number received as a new horizontal location, and so 
forth. When outputting data from arrays, DRAW and RDRAW require two data arrays. In 
the above example program, examine the DRAW command at statement 370. The location 
of the first displayed point is specified by X(1) and Y(1). The second point's location is 
specified by X{2) and Y(2). 

The graphic commands DRAW, MOVE, and GIN each have a counterpart which addresses 
an actual display location. 

These counterparts are listed in the following table: 

Arguments interpreted Arguments interpreted 

as User Data Units as GDU's 

DRAW X,Y PRINT @32,20: A,B 

MOVEX,Y PRINT @32,21 : A,B 

GINX,Y INPUT @32,24: A,B 

For example, the execution of the statement PRINT @32,20: 65,50 always draws a line 
to the center of the screen regardless of the parameters of the WINDOW, VIEWPORT, and 
SCALE statements, and the present position of the graphic point. This command will draw 
a line to a point which is outside a specified window and viewport; the clipping and trans- 
formation done to lines produced by the DRAW command is not done to lines produced by 
the PRINT command. PRINT @32,21: A,B causes the graphic point to be moved to a point 
on the display specified by the contents of variables A and B. INPUT @32,24: A,B causes 
the actual location of the graphic point in GDU's to be placed in variables A and B. (This 
command and the GIN statement are two commands useful for determining where the 
graphic point is at a given time.) With all three of these statements, the first argument (called 
A in the above examples) is interpreted to be the horizontal location in GDU's, and the 
second argument (called B in the above examples) is interpreted to be the vertical location 
in GDU's. 

There are no statements corresponding to RMOVE and RDRAW which operate in GDU's 
only. 

Since graphic information is sent to any graphic device in the maximum precision of which 
the Graphic System is capable, the displayed resolution is determined by the graphic device 
hardware, not by the Graphic System. The number of addressable points on the Graphic 
System display is 1024 (horizontal) by 780 (vertical). Therefore, the display's resolution 
is approximately 1/8 or .125 GDU. With 3000 by 2000 addressable points, the 4662 
plotter is significantly more precise. Its resolution is approximately .05 GDU. 
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The WINDOW and VIEWPORT commands determine how user data units are transformed 
to GDU's. This transformation process is entirely internal to the Graphic System and is 
totally independent of any graphic device, including the Graphic System display. Within 
the numeric limits of the Graphic System, any window can be transformed nto any view- 
port. A command such as VIEWPORT 500,1000,200,400 will define a conceptually valid 
transformation which is used by the Graphic System. However, no graphic information will 
ever reach the display because all graphic information would be transformed into locations 
outside the 130 by 100 GDU limits of the Graphic System display. This condition is known 
as scissoring. It occurs when the graphic device hardware attempts to execute an action it 
is not capable of performing, such as moving the graphic point to the position 500,200 in 
GDU's. Scissoring usually reflects some kind of user error. What action actually results when 
scissoring occurs is determined by the hardware of the particular graphic do^/ice. Since 
graphic devices have different hardware configurations, scissoring produces different actions 
in different devices. When commanded to perform an action it is not capable of performing, 
the Graphic System display does nothing: the physical graphic point does not move. 

Scissoring is very different from clipping, a needed function performed by the Graphic 
System before the graphic information is output to the graphic device. Clipping permits 
drawing to and from points located anywhere in user data space, even those which are out- 
side the defined window. 



Scissoring occurs when two types of errors have been made: when an improper viewport 
has been defined (e. g., VIEWPORT 300,500,200,400), and when the display is directly 
instructed to place the graphic point outside the GDU limits with a PRINT command 
(e. g., PRINT @32,20: 200,200). 



PLOT 50 GRAPHIC PROGRAMMING REV A, SEPT 1978 ^-21 



APPENDIX A 

GRAPHIC POINT CONTROL 



GRAPHIC POINT CONTROL 



Throughout this manual, the words "cursor" and "graphic point" have been used almost 
interchangeably to specify a location on the display. There are situations where they do 
not represent the same location. It is sometimes necessary to distinguish between the 
location of the physical graphic point on the display and the location of the graphic 
point in user data space. When a program is not running, the location of the physical 
graphic point on the display is shown by the position of the blinking rectangular dot 
matrix. This is always the starting point for character information printed on the display. 
In the vast majority of instances, this is also the starting point for any lines drawn on 
the display. 

The location of the graphic point in user data space is called the logical graphic point in 
this appendix. The position of the logical graphic point is affected only by graphic commands, 
such as MOVE and DRAW, not by other output commands such as PRINT. Whenever 
WINDOW, VIEWPORT, or SCALE are executed, the physical graphic point is not moved 
but the location of the logical graphic point (in user data space) is changed so that the two 
locations coincide. The physical and logical graphic points will not coincide after any of 
the following events occur: 

» The execution of any non-graphic command which moves the physical graphic point on 
the display. PRINT is such a command. It changes the actual location of the graphic 
point without changing the location of the logical graphic point in user data space. 

♦ The execution of a DRAW command to a point outside the defined window. Although 
the location of the logical graphic point is updated correctly, the physical graphic point 
is placed at the intersection of the drawn line and the defined window boundary. 




Logical 

Graphic 

Point 

Physical 
Graphic 

Point 



All subsequent graphic commands are executed properly. However, the values returned 
by GIN will not reflect the location (in user data space) which coincides with the physi- 
cal graphic point, not the logical graphic point. 



A-22 



REV B, SEPT 1978 



PLOT 50 GRAPHIC PROGRAMMING 



APPENDIX A 
GRAPHIC POINT CONTROL 



* The execution of a MOVE command to a point whose transformed location is outside 
the GDU limits of the graphic device being addressed. In the case of the Graphic System 
display, this situation is produced by the following commands: 

INIT 

MOVE 200,200 



Logical 

Graphic 

Point 




Physical 
Graphic 
Point 



When these commands are executed, the physical graphic point does not mo^/e at all, even 
though the logical graphic point is located correctly. As with the situation produced by a 
DRAW command described above, subsequent graphic command are executed properly 
but the GIN command will reflect the location of the physical graphic point, instead of the 
logical graphic point. 

There are several ways to ensure that the physical and logical graphic points coincide. 
Here is one: 

250 GIN A,B 
260 MOVE A,B 

The values returned by the GIN command show the location in user data space which 
coincides with the location of the physical graphic point. A MOVE to that point updates 
the location of the logical graphic point so that the two points coincide. This is useful when 
graphic and non-graphic information is mixed, as shown below: 

310 GIN A,B 

320 PRINT "HELLO"; 

330 MOVEA,B 
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Here is another method: 



320 PRINT "HELLO" 
330 RMOVE 0, 



The RMOVE command at line 330 (above) will cause the physical and logical graphic 
points to coincide whenever the logical graphic point is inside the physical limits of the 
graphic device. This is another way to approach the problem solved on page 1-57. 
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TCS SUBROUTINES 



Many Graphic System users may already be familiar with the Terminal Control System 
software of Tektronix. Listed below are TCS subroutines which are similar to Graphic 
System graphic commands: 



TCS 

DRAW A 

DRAWR 

DRWABS 

DWINDO 

HOME 

MOVE A 

MOVER 

MOVABS 

NEWPAG 

R ROT AT 

SEELOC 

TWINDO 

VCURSR 



GRAPHIC SYSTEM 

DRAW 

RDRAW 

PRINT @32,20: 

WINDOW 

HOME 

MOVE 

RMOVE 

PRINT @32,21: 

PAGE 

ROTATE 

INPUT @32,24: 

VIEWPORT 

POINTER 



No TCS subroutines are equivalent to the Graphic System commands GIN and SCALE. The 
RSCALE subroutine in TCS applies only to relative vectors while the SCALE command of 
the Graphic System applies to both absolute and relative lines. The TCS corhmon vari- 
ables TREALX and TREALY contain the same type of values which GIN places in its 
target variables: the location of the virtual cursor (or logical graphic point) h user data 
space. The Graphic System command AXIS has no TCS equivalent. 
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REFERENCES 

Listed here are some materials whicfi discuss computer graphics in general. Since much more 
has been published regarding specific topics in computer graphics, this is only a tiny fraction 
of the available literature. 



BOOKS: 

Newman, W. and Sproull, R., Principles of Interactive Computer Graphics, McGraw-Hill, 
NewYork, 1973. (Text book with detailed discussions of hardware, software, algorithms, 
data structures, and other topics. Includes large bibliography.) 

Nelson, T. H., Computer Lib/Dream Machines, $7 from Hugo's Book Service, Box 2622, 
Chicago, III. 60690. (Informal introduction to computers in general. Also discusses com- 
puter graphics and other computer related topics.) 



PERIODICALS: 

Computer Graphics available from ACM-SIGGRAPH 1 133 Avenue of the Americas, New 
York, New York 10036. SIGGRAPH is the special interest group for computer graphics, 
part of the Association for Computing Machinery. The Spring 1975 issue of Computer 
Graphics (Vol. 9 No. 1 ) is The Proceedings of The Second Annual Conference on Computer 
Graphics and Interactive Techniques. 

ACM Computing Surveys Vol. 6, No. 1 (March 1974). ACM 1 133 Avenue of the Americas, 
New York, New York 10036. This issue has two articles: "A Characterization of Ten Hidden 
Surface Algorithms" and "Computer Processing of Line Drawn Images". 

Proceedings of The IEEE (April 1974). Institute of Electrical and Electronic Engineers, 
347 East 47 Street, NewYork, NewYork 10017. Special issue on Computer Graphics. 



ARTICLES OF GENERAL INTEREST: 

Sutherland, I. E., "Computer D'\sp\ays" , Scientific American , June 1970, pp. 57-81. 



CONFERENCE PROCEEDINGS: 

Significant papers about computer graphics appear in proceedings from the National 
Computer Conference, The Fall Joint Computer Conference, and The Spring Joint 
Computer Conference. Available from: 

AFIPS Press 

210 Summit Avenue 

Montvale, New Jersey 07645 
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Note 

During string comparisons, lower case characters (gray tint) are converted to ttieir uppercase equivalents. 
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Aspect Ratio 4-«, 8-1 

Appending Data to an Array 2- i 2 

AXIS 1-41,5-1 

Axis Labels 6-"' 5 

Bar Chart 3- : 4 

Centering a Printed Character 3-(j 

Changing a Data Item in an Array 2-' 1 

Character Refresh 7- 8 

Character Size 1 -52 

Clipping 1-7 

Control Characters 1 -{,3 

Data Input 2-' 

Deleting a Data Item From an Array 2-' 3 

DRAW 1 -■ , 1 -21 

Editing Data in an Array 2-10 

Exponential Transform 4-- 

Expression 1 -£• 

Fonts, Character 7-f 8 

Function, Graphing a 2-1 5 

GIN 1-f.9 

Graphic Display Unit 1-10 

Graphic Input 1 -£,9 

Graph Nomenclature vii 

Grids 5-16 

Histogram 3-14 

HOME 1 -21 

Inserting a Data Item into an Array 2-14 

Listing Data in an Array 2-10 

Log Transform 4-10 

Log AXIS 5-18 

Logic Transform 4-10 

MOVE 1-1, 1-21 
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Numeric Constant 1-2 

PAGE 1-21 

Pie Chart 3-19 

Polar Transform 4-10 

Polar AXIS 5-24 

Positioning Cliaracter Strings 6-10 

Positioning witii Control Characters 1 -53 

Power Transform 4-1 

Refresh Character 7-18 

RDRAW 1-22 

Retrieving Data from Tape 2-18 

RMOVE 1-22 

ROTATE 1-25 

SCALE 1-18 

Size of Character 1 -52 

Storing Data on Tape 2-18 

Symbols, Drawn 3-7 

Symbols, Printed 3-5 

Tic Mark Labels 6-20 

Titling 6-9 

User Data Unit 1-3 

Variable 1-2 

VIEWPORT 1-10 

WINDOW 1-3 
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